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How Much Computer Do You 
Need? 

I was recently asked "What com- 
puter should I buy?" and of course, my 
answer was "What do you want to do 
with it?" This lead to a long discussion 
and some time spent looking through the 
many pages of advertising in Byte and 
The Computer Shopper. We ended up 
overwhelmed by the number of choices 
available in today's market. When I 
bought my first computer the choice 
was between Commodore, Radio Shack, 
Apple, or CP/M, but today there are so 
many products on the market that it is 
no longer that simple. 

When choosing a computer you 
should first select the software you 
need, and then get the system which 
runs that software. A survey of the 
current software showed that there 
were more new programs being 
released for the IBM-PC and its com- 
patibles than for any other system. In 
fact, there are probably more releases 
for the IBM-PC than for all the other 
systems combined! This means that I'll 
have to recommend the PC or one of its 
clones for a non-technical user in a nor- 
mal business office environment, based 
on the large number of available 
programs, user's support, and the 
general needs of an unsophisticed user. 
Helping someone else select a system 
forced me to think about defining what 
a computer is, and how much computer 
is really needed. The usual reaction is 
to attempt to get one system that is 
powerful enough to fill all our needs, 
but the complexity and awkwardness of 
the system increases rapidly with size, 
and it can be very dificult to perform 
simple functions with a large system. 
There will never be the one "perfect 
computer" which satisfies all needs for 
everyone, because we each have dif- 
ferent needs. In fact, I'll never be 
satisfied with just one computer 
because I have a wide range of ap- 
plications. Besides, two smaller 



systems enable me to run two entirely 
different types of operations at the 
same time, and will probably cost less 
than one larger multitasking unit. 
A better choice is to define the 
requirements on as low a level as 
possible, and then combine these 
requirements into similar groups in or- 
der to determine what type of system 



"There will never be 
the one 'perfect 
computer' which 
satisfies all needs 
for everyone..." 



or systems are required. Some of us are 
computer nuts who would like to have 
one of everything to play with, but the 
limited funds available for computers 
force us to take a more realistic view of 
our needs. 

My uses can be roughly divided into 
two areas, which are the business of 
running this magazine, and personal 
projects, with a lot of overlap since the 
magazine is about computers. The 
business applications include word- 
processing and phototypesetting from 
disk to produce the copy, a data base 
for maintaining subscription records 
and mailing lists, and a spreadsheet for 
financial forecasting. These needs can 
be served by either the original Apple 
II + I started with, or the two S-100 Z- 
80 systems running CP/M. I prefer the 
CP/M systems for the business because 
of the higher capacity 8 * disks, the soft- 
ware, and the operating system. 

My personal projects involve general 
hardware and software hacking, lear- 
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ning additional languages and im- 
proving my programming skills, and 
applying computers for the 
measurement and control of real world 
devices. Most of my time has been 
spent on the magazine, so I haven't 
been able to do much with my personal 
projects, but I want to automate my 
lathe, build a remote weather station, 
monitor and control a solar heating 
system, and experiment with robotics. 
For this I need an open system with 
good I/O capabilites, an accessible bus, 
and a flexible operating system. Both 
the Apple and the CP/M systems work 
well here, and it is difficult to choose 
betwen them. The Apple has the ad- 
vantage of having BASIC and a 
reasonably decent monitor in ROM, 
high resolution graphics, good low-cost 
assemblers, and reasonably priced car- 
ds for A/D and interfacing. The S-100 
CP/M system has a better selection of 
languages, high capacity disks, a more 
powerful and flexible operating system, 
and better I/O capabilities, but inter- 
facing cards are more expensive. I in- 
tend to continue working with both 
systems for program development, and 
then will use SBC's (such as Davidge) 
and microcontrollers (such as Basicon) 
for dedicated controllers. 

What Can You Do With An Old 
Computer? 

When you finally decide to get a 
newer, more powerful computer you 
are faced with the problem of deciding 
what to do with the old one. Because of 
the rapid advances, it isn't worth much 
on the used computer market if it is 
more than two or three years old, and 
yet it is still working and too good to 
throw away. One answer is to use it to 
relieve your main system from some 
low-level, time consuming operations, 
such as the print spooler described in 
Piotrowski's article on "Poor Man's 
Distributed Processing" in this issue. 
I'm satisfied with my two eight bit 
systems for now because I still have a 
lot to learn, but I would like to upgrade 
to a 68000 16 bit system in the 
future — not because I need it, but just 
for the challenge of new things. One of 
the things that I really like about the S- 
100 system is that I can experiment 
with the 68000 by building the 68008 
board described in Kohler's article in 
the last issue without replacing the 



whole system. 

Right now I have absolutely no 
desire for an IBM-PC or one of its 
clones, but I think that their bringing 
out the PC was of great benefit to har- 
dware hackers. Not that we'll buy their 
computers, but rather that all the non- 
technical users are flocking to the IBM- 
PC standard and dumping non- 
conforming equipment on the market at 
fire sale prices! It enables us to pick up 
great used equipment for very little 
cost (watch for Kibler's article on his 
$500 Superbrain in the next issue). 
You'll have to be able to help yourself 
when working with this older equip- 
ment because the manufacturer will 
either be out of business or will refuse 
to support the obsolete equipment. 
That's one of the purposes of this 
magazine — to help you learn to use an 
assembler and a debugger to patch the 
operating system, and to provide the 
means for you to contact others who 
have experience or documentation for 
the older systems. This is your 
magazine . . use it! 

A New Look For The Journal 

This is our second issue with our new 
three column format. We made this 
change for easier readability, to im- 
prove the layout with larger 
illustrations and program listings, and 
to provide for l/9th page ads. In ad- 
dition to the smaller ads, we are also 
adding classified ads in order to help 
individuals and smaller companies 
reach their markets and to make new 
developments in specialized fields 
available to our readers. The classified 
ads are 25 cents per word, paid in ad- 
vance, and can be charged to your Visa 
or Master Charge, but we prefer not to 
take these ads over the phone because 
of the chance for errors. 

Information Is For Sharing 

The most important function of a 
journal is to provide a place for you to 
share your thoughts, ideas, problems, 
and solutions. We need your articles, 
letters, and comments. If you disagree 
with one of our authors, tell us. If you 
can expand on something we publish, 
tell us. If you need the answer to a 
problem, tell us. What you send doesn't 
have to be formal or fancy, just get us 
the information so that we can share it 
with others. ■ 
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Dear Computer Journal: 

I'm writing in response to the article 
"The State of the Industry," by Bill 
Kibler in Issue 15 of The Computer 
Journal While Kibler has some good 
things to say, there are also some poin- 
ts I disagree with, primarily dealing 
with his adamant dislike for the IBM 
PC. While I realize the IBM PC has 
several shortcomings for us ideal- 
computer lovers, I also believe IBM has 
done much more good than harm to the 
microcomputer industry. 

When IBM introduced their PC 
"...not compatible with anything" as 
Kibler puts it, I don't think it was quite 
the joke that Kibler seems to think it 
was. Although it is impossible to know 
all of the reasons why IBM chose the 
architecture that it did (many were 
economical, to be sure), there were 
many very good reasons for deviating 
from what was already available at the 
time. Among them is the limited 
memory space permitted by the 8-bit 
CPUs common to most of the systems 
of that time. Using a CPU with the 
ablility to directly address up to one 
megabyte of main memory allows the 
PC to run many programs and hold a lot 
of data that would be impractical or im- 
possible on the typical 8-bit CP/M 
machines common at the time (and still 
ubiquitous today). 

The interrupt-oriented architecture, 
DMA capability and standardized har- 
dware expansion slots (that is, its open 
system architecture) are other positive 
features of the IBM PC. The expansion 
slots are one of the most attractive 
features of the Apple II, in my opinion. 

Above all else, IBM did something 
for the microcomputer industry that 
needed to be done: they created a stan- 
dard. The few standards previously 
established, in particular the Apple II 
and CP/M, were not sufficient to meet 
the needs of many businesses and other 
users. IBM created a standard with an 
80 column screen (I never could get 
used to Apple's 40 columns!), a 
(reasonably) good keyboard that in- 
cludes lower case and special function 
keys, and an open system architecture 
that allows easy system expansion. 
IBM also set a standard for the 10 M- 



byte Winchester drive, helping drop 
hard-disk prices. 

Don't get me wrong. I'm not blind to 
the shortcomings of the IBM PC. In- 
deed, I dislike the segmented architec- 
ture of the 8086 family (including the 
PC's 8088). Fortunately, the segmen- 
tation problem is transparent to the 
user in most of the good application sof- 
tware available for the PC. I wish to 
this day, however, that IBM would have 
chosen the far-better 68000 family. My 
opinion concerning the IBM PC family 
of computers is reflected in an editorial 
statement by Phil Lemmons, Editor in 
Chief at Byte magazine, in their 1984 
Guide to the IBM Personal Computer: 
"For the present, it makes more sense 
to enjoy the benefits of the current IBM 
standard than to curse it because it 
could be better. But enjoying the 
benefits of this standard shouldn't 
prevent us from keeping an eye open 
for something really new." 

R.C.A. 

Michigan 

Dear Computer Journal: 

Please find my check for a one year 
subscription enclosed. I would like to 
get a copy of the first two sections of 
your article "Write Your Own 
Threaded Language." Part three was in 
your sample copy and I enjoyed it very 
much. As an old hobbyist (circa 1972) I 
have become concerned that the hobby 
(computers) movement is being 
steamrollered by highly integrated 
technology on one side and suffocated 
by the tide of appliance computers on 
the other. Thus, I fully support your 
Journal. My interest currently is in the 
development of a 32 bit microprocessor 
based single board computer in the low 
cost style of the "Big Board" marketed 
by Digital Research of Texas. The 
board should have the capability of 4 
megabytes of memory, floppy and hard 
disk peripherals, six to eight serial 
communication ports, and the same 
number of parallel ports. I feel that 
hobbyists need an architecture that is 
unique to their needs such as con- 
currency of tasks. 

W.F.B. 

Massachusetts 



Dear Computer Journal: 

Recently, I renewed my subscription 
to The Computer Journal Due to a 
limited budget, both of money and of 
time, I try to limit my reading to those 
magazines that cover the technical 
aspects of computers. By profession I 
am a programmer; by avocation I enjoy 
working with the hardware of com- 
puters and electronics. 

Recently it has been obvious that the 
magazine industry has gone on a binge 
of producing computer magazines 
aimed at the user only, indeed at the 
novice user, virtually ignoring the avid 
hobbyist or interested techie. This ten- 
dency has even led to the demise of 
MicroSystems, which had been my 
favorite magazine, and Microcomputing 
which had been reasonably good until it 
was 'conglomeratized'. Fortunately this 
trend should be self-correcting, and the 
disappearance of many of these new 
user magazines is already taking place. 
But in the meantime some good 
magazines are also being lost. 

Some people are 'fighting back' by 
correctly pointing out that the real 
audience for computer mag's is the 
sophisticated user, builder, designer, 
etc.. The nearest analogy is that while 
almost everyone drives a car there are 
virtually no magazines that feature ar- 
ticles such as "The Correct Grip on the 
Steering Wheel," yet there do exist car 
magazines aimed at the truly in- 
terested car enthusiasts, and they sur- 
vive even while appealing to only a 
fraction of the car driving public. In fact 
they survive only by appealing to a 
limited audience. 

I think The Computer Journal is a 
good, even needed magazine, and I 
want to see it survive. But I think it 
needs to find its niche. While reviewing 
the previous year's issues I am struck 
by the wide range of articles, going all 
the way from the most basic (Database 
Design, for instance), to the esoteric 
("Wire Wrap a 68008 CPU"). I am also 
struck by the thinness of the issues; the 
whole year takes up only as much shelf 
space as three issues of Byte. But thin- 
ness is relative - better to have a few 
good pages than a hundred meaningless 
ones, (continued) 
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One thing that I enjoyed in other 
magazines such as MicroSystems was 
product reviews, especially reviews of 
products offered as kits. Reviews of 
kits are helpful to those of us who like 
to build them and even to the in- 
creasingly limited number of suppliers. 
I like to read kit reviews since I can't 
build all the kits that are offered (many 
of them I might not use), and want to 
know about the ones I would like to 
build. Reviews and articles about kit 
building can't but aid the industry, even 
when they include justified criticism of 
a particular kit. 

Very truly yours, 

J.O. 

Massachusetts 

Dear Computer Journal: 

Thank you for a terrific magazine! 
Just as two other publications, 
Microsystems and Microcomputing, 
disappeared over the horizon, The 
Computer Journal came into view. 
Microsystems was terrific, and so was 
Microcomputing's predecessor, 
Kilobaud. I will miss them. I think The 
Computer Journal will do better than 
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just fill the void. 

There is a small group of dedicated 
microcomputerists in the Los Angeles 
area called "The Southern California 
Digital Group Computer Society." We 
are concerned almost exclusively with 
the preservation, maintenance, and fur- 
ther development of original Digital 
Group systems. We address both har- 
dware and software issues. At a recent 
meeting I spoke about your magazine 
and almost everyone indicated an in- 
terest in subscribing. 

Software ranges from operating 
systems -CO/M, OASIS. [PHIMON, 
DISKMON. MOPS (native Digital 
Group op. sys.)], MCOS, and OPUS; to 
languages -BASIC. FORTRAN, C, 
FORTH, Assemblers of all sorts; and 
applications that run the gamut from 
terminal emulators to accounting 
systems and data base tools. 

Hardware typically is dedicated to 
the SUDING bus as originally presen- 
ted by The Digital Group, although 
there have been many successful adap- 
tations of S-100, Apple and TRS80 com- 
ponents. Recent refinements include 
4mhz Z-80 CPU with on-board clock and 
calendar (with battery for continuous 
power-off function) and "heart-beat" for 
interrupt driven multi-user operation 
with intelligent co-processors provide 
sophisticated I/O management, ter- 
minal emulation, 512K pseudo-disk fun- 
ctions and much more. 

Current projects include design and 
development of multiple concurrent 
processors (they may be dissimilar) and 
the related software. The local group 
meets every two months. There is also 
a national newsletter. Anyone in- 
terested in Digital Group systems may 
contact me at the address below. 

Sincerely, 

Fred G. Sutton 

Pres.. SCDGCS 

1230 S. Helberta Avenue 

Redondo Beach, CA 90277 

Dear Computer Journal: 

I enjoyed your articles on "Con- 
trolling the Hayes Micromodem II 
From Assembly Language." 

As a related question, I wonder what 
information is available on emulating 
block mode terminals. I realize that 
there are several different standards 
for block mode terminals, but there 
doesn't appear to be any block mode 



software available for the Apple II. 
As a starting point I'd like to see 
some general information as to how the 
data and information codes are packed 
for transmission. Do you know where I 
could find some source material? 

Sincerely, 

F.K. 

Los Angeles, CA 

Ed: Readers, can you help? 



Dear Neil Bungard: 

This is to express appreciation for 
your trouble shooting/interfacing series 
in The Computer Journal I have a file 
folder at least s /« " thick with references 
to trouble shooting techniques and cir- 
cuits. It occurred to me that perhaps an 
annotated bibliography for The Com- 
puter Journal would be worthwhile. 
One particular device that I have wan- 
ted to build, but could never quite dope 
out from the printed material, was a 
test circuit described by Bob Cushman 
in EDN about five years ago, which 
originated with some Motorola 
engineers. It's essentially a method of 
looking at all data lines as latched at a 
given (thumb-switch selected) address. 
I have access to a fairly complete file of 
Wireless World, where a number of 
devices of varying complexity have 
been described. 

I have looked, unsuccessfully, for a 
suitable circuit for a pulse injection 
probe with the versatility of the 
Hewlett Packard device, which senses 
whether a point is high or low, and 
pulses it in the appropriate direction. It 
is (as I recall) somewhat flexible in 
pulse duration. Any ideas? 

Electronics (Australia) in December 
1977, published full details on a 40 
channel tester in which the condition of 
up to 40 points was latched and held, 
under control of a variable time- 
delayed strobe triggered from a reset 
(or other 'time zero') system reference. 
Thus the response of the 40 latched 
LEDs can be 'walked' through a total 
time excursion of several milliseconds 
as the time-delay controlling poten- 
tiometer is rotated and the timing 
sequence thus inferred. It looks as if 
that will be my next project. 

Sincerely, 

H.M. 

Hinsdale, IL ■ 
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POOR MAN'S DISTRIBUTED PROCESSING: 

Cross Development and Using the H-8 as a Print Buffer 

by Walt Piotrowski 



I 



wonder how many computers 
there are in the world that still com- 
pute but have been taken out of service 
because their owners' needs have 
changed? There are the starter 
machines which were intended to be 
outgrown (although their purchasers 
may not have known that), and there 
are a growing number of very capable 
machines that have been replaced 
because of advances in technology. At 
the same time, there are a number of 
things around the house, or the com- 
pany, that could be done quite well by a 
computer but are not being done 
because the newer models are too ex- 
pensive or powerful to dedicate to 
these tasks. Energy control and 
security come to mind fairly quickly. 
An old computer can also be put to use 
as a smart peripheral or a data 
preprocessor for a newer machine. You 
could, for example, build real world in- 
terfaces for the old machine that might 
void the warranty on your newer 
machine and then transfer the data 
between the old one and the new one 
using a commercially available inter- 
face. You could also help advance the 
state of the art yourself by experimen- 
ting with loosely coupled distributed 
processing. 

The old machine that you put to use 
in this way does not have to be a com- 
plete system. It is common to develop 
software on a fully equipped system 
and then use that software on another 
system that does not have a full com- 
plement of peripherals. It's regularly 
done in the commercial and military 
worlds (automobiles and missiles both 
have computers in them) and it can also 
be done by an individual if he's willing 
to substitute some ingenuity for expen- 
sive test setups. This article contains a 
general discussion of the principles of 
cross development and then shows 
their application in the development of 
a printer buffer using a Heathkit H-8 
that had no peripherals of its own. 



Cross Development 

There are two major processes in 
software development that actually 
make use of a computer. The first is 
code generation. Code generation uses 
an editor for entry of source statemen- 
ts, an assembler or compiler for tran- 
slation of source statements to an in- 
termediate object code, and a linker or 
loader for generation of the final object 
code. The second process is code testing 
and, for the kind of program that we 
are considering here, usually requires 
additional debug aids of some kind. 

The two computers involved in a 
cross development are called the host 
and the target. The host is sometimes 
called the development system and it 
usually has a disk operation system and 
a full complement of peripherals. 
Generally, all parts of the code 
generation process are done on the 
host. The target is normally a minimum 
system and doesn't have enough har- 
dware to support an operation system. 
Although some tests must be done on 
the target, it's quite common to do at 
least part of the testing on the host 
with only a final test on the target. In 
addition to these two processes, which 
are done in any software development, 
cross development also involves an ad- 
ditional step of transporting the object 
code from the host to the target. In- 
terestingly, I've heard people who do a 
great deal of this kind of work talk 
about normal programming as a cross 
development in which the host and the 
target are the same system. 

Code generation is less expensive if 
the host and the target have the same 
microprocessor as their base machine. 
Both may be based on 8080s for exam- 
ple. In this case, you can use the host's 
normal compilers, assembler and loader 
to produce the object code. If the two 
systems are not based on the same 
processor, the extra expense comes 
from the need to buy (or write) a cross 
development tool like a cross assembler 



or a cross compiler. Cross assemblers 
are advertised regularly in most ad- 
vanced computing magazines and are 
also available in the public domain. I 
haven't seen any cross compilers ad- 
vertised, but they may be available if 
you make inquiries in the right places. 

The strategy that you adopt for code 
testing is also influenced greatly by the 
base processors of the two systems. If 
they are the same, you test portions of 
the target's software on the host, using 
the host's normal debug tools and 
peripherals. If you are careful when you 
structure the program, you may be able 
to test a very large percentage of it on 
the host and leave only the portion that 
handles the target's I/O functions for 
test on the actual target system. 

If the two processors are not the 
same, there are still several test op- 
tions open to you. One option is the use 
of an instruction level simulator (ILS) 
to simulate execution of the target's in- 
struction set on the host. Instruction 
level simulators for the simpler 
processors like the 6502 or 8080 are 
relatively easy to write, and many 
people write them in high order 
languages. Once you have an ILS, you 
can use it to do the same kind of testing 
on the host that you would do if the two 
base processors were the same. (As of 
this writing, I have not seen any in- 
struction level simulators available 
commercially or in the public domain.) 
Another test option, if you are writing 
part of the target program in a high 
level language, is the use of two 
separate compilers. One of these is the 
cross compiler that you will use to 
produce the code for the target 
machine. The other is a compiler to 
produce code that you will test on the 
host. If both compilers are of good 
quality, you can be confident that once 
the high level language portion of your 
program works on the host, it will run 
correctly on the target. 

If the target is really a "minimum" 
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system, testing on the target will 
probably be at the machine language 
level. In the professional cross 
development world, there are exotic 
test tools (like in-circuit emulators) that 
allow you to use the power of the host 
while testing the target, but these 
require more hardware than you or I 
, will probably ever have. In our en- 
vironment, test aids on the target 
system will be sparse. The tools that 
are available and the complexity of the 
program that you are testing will in- 
fluence the amount of work that you 
will be able to leave for the target 
machine. Testing with no tools at all 
might be possible but it would require 
either that your program be extremely 
simple or that you possessed an in- 
credible amount of intuitive reasoning 
capability (or luck). A control panel is 
the lowest level test tool and the step 
beyond that, if you are lucky, is a debug 
program that does not require an 
operating system for I/O support. A 
debug program, however, would 
require that you had a terminal 
available to run it. The final problem is 
the transmission of object code from 
the host to the target. There are 
several approaches. Writing a diskette 
or a cassette tape on the host and 
reading it on the target is certainly the 
simplest, but is probably the least 
likely since it requires that the systems 
have compatible peripherals. For our 
minimum target system, a more likely 
solution is a communication link. For 
most of us who are using old systems, 
the available link will be RS-232. The 
protocol for the communication that 
you do over the link depends a great 
deal on the intelligence level of the 
target system when its power is first 
turned on. In the best case, the target 
has a ROM that will boot from the link. 
(In the good old days, we used teletypes 
and our mass storage was paper tape, 
so this isn't as far fetched as it sounds.) 
The next best case, if the target 
machine has a control panel, is to use 
the panel to enter a small boot routine 
by hand. If you choose this as an option, 
you may want to consider a two stage 
download. The first stage can be a very 
unsophisticated program that will only 
download a more sophisticated loader. 
This exotic loader can then download 
the actual software while doing error 
checking on the transmission. As a 
bonus, if you do your download via RS- 
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0005 = 


BDOS 


EQU 


5 




0023 - 


FSIZE 


EQU 


35 


(File Size Code 


000F = 


OPEN 


EOU 


15 


(File Open 


0010 = 


CLOSE 


EQU 


16 


(File Close 


0014 = 


RDSEO 


EOU 


20 


'Read Seauential 


001A = 


SETIlMA 


EQU 


26 


•Set disk address 


005C = 


FCB 


EQU 


3CH 


•File Control Block 


007D = 


FCBSIZ 

1 

SYN 


EOU 


7DH 


• FCB Size Field 


0016 = 


EQU 


16H 


•ASCII Sync 


0002 * 


STX 


EQU 


2 


•ASCII STX 


0020 - 


BLANK 

* 

SECSIZ 

* 

BUFST 

t 


EQU 


20H 


•ASCII Blank 


0080 ■ 


EQU 


128 


•Disk sector size 


0800 ■ 


EQU 


800H 


•Input buffer 


0100 


• 


ORG 


100H 




0100 210000 


HBLPR 


LXI 


HrO 


•Clear HL 


0103 3? 




DAD 


SP 


•Make a cop* of SP 


0104 225402 




SHLD 


STACK 


•Save for exit 


0107 315402 




LXI 


SP. STACK 


•Get local stack 


010A 3A5D00 




LDA 


FCB+1 


•Look at file nana 


010D FE20 




CPI 


BLANK 


•Not supplied' 


010F CAD801 




JZ 


EREXIT 


•Error - no file naae 


0112 OEOF 




MVI 


C.OPEN 


•Open file code 


0114 115C00 




LXI 


D.FCB 


•FCB Address 


0117 CD0500 




CALL 


BDOS 


•Open it 


011A 3C 




INR 


A 


•Error code is 255 


011B CADB01 


1 


JZ 


EREXIT 


•Error - no file on disk 


011E OE23 




MVI 


C. FSIZE 


• File size coaeand 


0120 115C00 




LXI 


D.FCB 


IFCB Address 


0123 CDO5O0 




CALL 


BDOS 


•Get size coaputed 


0126 3A7D00 




LDA 


FCBSIZ 


•Oct size LSBs 


0129 320B02 




STA 


FILSIZ+1 


IH8 snaps thee 


012C 3A7E0O 




LDA 


FCBSIZ+1 


(Get MSBs 


012F 320A02 




STA 


FILSIZ 


•Swap these too 


0132 0607 


HUL128 


MVI 


Br7 


•Loop Ctr 


0134 AF 


MULLP 


XRA 


A 


•Clear Carry 


0135 3A0B02 




LDA 


FILSIZ+1 


•Get LSBs 


0138 17 




RAL 




•Mult by 2 


013? 320B02 




STA 


FILSIZ+1 


•Put back 


013C 3A0A02 




LDA 


FILSIZ 


•Get MSBs 


013F 17 




RAL 




•Mult by 2 


0140 320A02 




STA 


FILSIZ 


•Put Back 


0143 05 




DCR 


B 


•Decreaent Loop Ctr 


0144 C23401 




JNZ 


MULLP 


(Not done wet 


0147 3A0A02 




LDA 


FILSIZ 


•Get LSBs 


014A 321102 




STA 


FILCTR+1 


•Save for counting 


014D 3A0BO2 




LDA 


FILSIZ+1 


(Get MSBs 


0150 321002 


( 


STA 


FILCTR 


(Counter - noraal order 




1 


Loop to 


read file in 


to eeaory 


0153 210008 




LXI 


H, BUFST 


•Input buffer start address 


0156 225602 




SHLD 


BUFAD 


(Save for use 


0159 E5 




PUSH 


H 


(Copy on stack 


015A Dl 


READLP 


POP 


D 


• Easy yev to transfer 


01SB 0E1A 




MVI 


C, SETDMA 


(Disk address set 


015D CD0500 




CALL 


BDOS 


(Set to local buf 


0160 11SC00 




LXI 


D,FCB 


(FCB Address 


0163 0E14 




MVI 


C.RDSEQ 


•Read Seauential 


0165 CD0500 




CALL 


BDOS 


(Read next record 


0166 C600 




ADI 





(Set fless 


016A C27B01 




JNZ 


CLOSIT 


•Read finished 


0160 2A5602 




LHLD 


BUFAD 


(Get buffer address 


0170 UBOOO 




LXI 


D, SECSIZ 


(Get sector size 


0173 1? 




DAD 


D 


(Point to next block 


0174 225602 




SHLD 


BUFAD 


(Put back 


0177 E5 




PUSH 


H 


(Copy on stack 


0178 C35A01 


« 

CLOSIT 


JMP 


READLP 


(Read next 


017B 115C00 


LXI 


D.FCB 


•FCB Address 


017E 0E10 




HVI 


C. CLOSE 


•File close code 


0180 C00500 




CALL 


BDOS 


•Close it 



Mrite to RS-232 



0183 CD5B02 



CALL 



OPMDEM 



(Open RS-232 
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232, you may be able to run a dubug 
program in the target by using your 
host, with a modem program, as a dumb 
terminal. 

Once you have your software up and 
running properly, you may want to con- 
sider streamlining the whole process by 
eliminating the download from the 
host. The standard approach is to burn 
the software into a PROM. A good 
possibility, if your machine has a boot- 
up ROM, is to replace the existing ROM 
with your own. This also opens up the 
possibility of using your old machine as 
a stand-alone process controller in 
remote locations. 

An Ideal Target Machine 

My first home computer was a Heath 
H-8, which I bought shortly after they 
were announced. My initial investment 
in the computer, a terminal, two casset- 
te recorders and a printer destroyed 
the family budget for a couple of years. 
When disk drives became available, I 
was still making the monthly payments 
on the equipment that I had already 
bought. For a lot of reasons, I wasn't 
active in home computing for a few 
years after the system was paid for 
and, when I finally got back to it, it was 
cheaper to buy a whole new system 
than to buy disk drives and more 
memory to upgrade my H-8. 

My new system has a lot of bottle- 
necks, but the most annoying is the 
30 character per second printer. (The 
printer, by the way, is the same Dec- 
Writer that I bought with my first 
system.) One night I was reading an ar- 
ticle about a printer buffer and I 
thought about my unused H-8. It has 
the two serial ports that are required 
by my hardware. One had been used for 
the console terminal and the other was 
used for the Dec Writer. Even though 
my H-8 only has 16K of memory, some 
quick arithmetic showed that it would 
hold about nine minutes worth of prin- 
ting at 30 cps. Not terrific, but not bad 
either. 

It turns out that the H-8 is almost 
ideally suited to be a target machine. It 
is based on the 8080 which means that 
any system that runs CPM-80 can be 
used as the development system. It was 
designed before the days of systems 
with integral keyboards and monitors, 
which means that it needed to have an 
RS-232 port to handle an external ter- 
minal. Its most important feature, 



0186 


0614 


MVI 


B.20 


•Urite 20 characters 


0188 


3E16 SYNLP MVI 


A.SYN 


(Get tunc character 


018A 


CD3902 


CALL 


URMDEM 


• Send to RS-232 


01BD 


05 


DCR 


B 


• Loop counter down 


018E 


C28801 


JNZ 


SYNLP 


*Do lore 


0191 


3E02 


MVI 


ArSTX 


•Get STX 


0193 


CDS902 


CALL 


URMDEM 


•Urite it 


0196 


210000 


LXI 


H.O 


•Clear HL 


0199 


221202 


SHLB 


CRCSUM 


•Clear CRC 


019C 


0608 


MVI 


B.HDRSIZ 


•Get header size 


019E 


210802 


LXI 


H.RECHDR 


•Record header address 


01A1 


7E HDRLP MOV 


A,M 


•Get character 


01A2 


CDE001 


CALL 


CRC 


• Update checP su« 


01A5 


CD5902 


CALL 


URMDEM 


•Send to RS-232 


01A8 


23 


INX 


H 


•Point to next char 


01A9 


05 


DCR 


B 


•Loop ctr down 


01AA 


C2A101 


JNZ 


HDRLP 


•Send tore 


01AD 


2A1002 


LHLD 


FILCTR 


•Get number of bates 


01B0 


EB 


XCHG 




•Put filsiz in DE 


01B1 


210008 


LXI 


H.BUFST 


•Buffer Address 


01B4 


7E DATLP MOV 


A.M 


•Data byte 


01B5 


CDE001 


CALL 


CRC 


•Update CRC 


01B8 


CD5902 


CALL 


URMDEM 


•Output the char 


01BB 


23 


INX 


H 


•Point to next char 


01BC 


IB 


DCX 


D 


•Loop ctr down 


01BD 


7A 


MOV 


AtD 


•Get LSBs 


01BE 


B7 


0RA 


A 


• Set Mass 


01BF 


C2B401 


JNZ 


DATLP 


•Not done 


01C2 


7B 


MOV 


A.E 


•Get MSBs 


01C3 


B7 


ORA 


A 


• Set Mass 


01C4 


C2B401 


JNZ 


DATLP 


•More chars to send 


01C7 


2A1202 


LHLD 


CRCSUM 


•Get CRC 


OICA 


7C 


MOV 


A.H 


•Get MSBs 


01CB 


CD5902 


CALL 


URMDEM 


•Write it 


01CE 


CDE001 


CALL 


CRC 


•Put it in too 


01D1 


7D 


MOV 


A.L 


(CRC LSB 


01D2 


CD5902 


CALL 


URMDEM 


•Send it 


01D5 


CDE0O1 


CALL 


CRC 


•See if it checks 


01D8 


CD5A02 


CALL 


CLMDEM 


•Close RS-232 


01DB 


2A5402 EREXIT LHLD 


STACK 


•Get CPM stack ptr 


01DE 


F9 


SPHL 




• Back into SP 


OlDF 


C9 

J 
1 
t 


RET 
CRC - 


Co»Pute CRC-16 





(X+1)»(X-15 + X+l) 

(Duplicate of the H-8 PAM CRC) 



01E0 


C5 


1 
) 

CRC 


PUSH 


B 


•Save <BC) 




01E1 


0608 




MVI 


B,B 


»(B)=Bit count 




01E3 


E5 




PUSH 


H 






01E4 


2A1202 




LHLD 


CRCSUM 






01E7 


07 


CRC1 


RLC 








01E8 


4F 




MOV 


CtA 


((O-Bit 




01E9 


7D 




MOV 


A.L 






01EA 


87 




ADD 


A 






01EB 


6F 




MOV 


Li A 






01EC 


7C 




MOV 


A>H 






01ED 


17 




RAL 








01EE 


67 




MOV 


HrA 






01EF 


17 




RAL 








01F0 


A9 




XRA 


C 






01F1 


OF 




RRC 








01F2 


D2FD01 




JNC 


CRC 2 


•If not to XOR 




01F3 


7C 




MOV 


A.H 






01F6 


EE80 




XRI 


2000 






01F8 


67 




MOV 


H.A 






01F9 


7D 




MOV 


A.L 






01FA 


EE05 




XRI 


SO 






01FC 


6F 




MOV 


Lt A 






01FD 


79 


CRC 2 


MOV 


A,C 






01FE 


05 




DCR 


B 






01FF 


C2E701 




JNZ 


CRC1 


•If »ore to So 




0202 


221202 




SHLD 


CRCSUM 






0203 


El 




POP 


H 


•Restore (HL) 




0206 


CI 




POP 


B 


• Restore (BO 




0207 


C9 


1 
i 

1 


RET 




• Exit 








Data 








0208 


81 


RECHDR 


DB 


81H 


• Type (tea laaae) t 


EOF 


0209 


01 




DB 


1 


•Record #1 




020A 


0000 


FILSIZ 


DB 


0.0 


•Nuaber of bytes 




020C 


2040 


H8NTRY 


DB 


20H.40H 


•H8 Entry (040 100) 




020E 


2040 


H8L0AD 


DB 


20H.40H 


•H8 Load Address 




0008 


* 


HDRSIZ 


EQU 


♦-RECHDR 


•Header lenath 




0210 


0000 


FILCTR 


DU 





•Output counter 




0212 


0000 


CRCSUM 


DU 





• CRC 
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however, is that it contains a built-in 
solution to the download and debug 
problems. 

The H-8 ROM contains a program 
that Heath called the Panel Monitor 
(PAM). The system boot routine is a 
part of PAM and the earlier H-8s nor- 
mally booted from cassette recorders 
through the Serial I/O and Cassette 
Board (H8-5). In the early days, Heath 
was trying to sell systems to people 
who already had teletypes and paper 
tape readers and, to accomodate them, 
they provided a port interchange swit- 
ch on the H8-5 board. When you flip the 
switch, the board exchanges the ad- 
dresses of the console port and the 
cassette port. The ROM, thinking it is 
still talking to a cassette, is actually 
handling the RS-232 line. Booting from 
an inter-computer link requires pushing 
just one button (as long as the host 
machine transmits the file using the 
protocol that PAM expects). PAM also 
contains a complete machine language 
debugger which takes commands from 
the front panel keys and displays 
results on the front panel LEDs. (The 
system would be perfect except for one 
■mall frustration: the panel monitor 
displays everything in octal, and 
CP/M's assembler prints everything in 
hex.) 

An assembly language program that 
will download from a CP/M system to 
an H-8 is provided with this article. 
The program takes the name of 
the file to be downloaded from the 
command line and expects to find a file 
by that name in COM format on the 
disk. It assumes that the program will 
load at the normal H-8 start address of 
2040H (040 100 in H-8 split octal). Get- 
ting the H-8 program into COM format 
after assembling it at 2040H requires 
some manipulations. These are given in 
a note at the end of the article. 

My CP/M system is a Commodore 64. 
In the C-64, handling the RS-232 port 
from CP/M requires code for both the Z- 
80 CP/M co-processor and the native 
6510. Since this code is lengthy and is of 
interest only to C-64 CP/M users, I have 
not included it in the listing. Instead, 
you will find a commented section at 
the end of the listing that shows where 
you should insert code to handle your 
host machine's RS-232 port. The com- 
ments also identify what the main 
program expects the subprograms to 
do. If you are a C-64 owner, contact me 



0214 
0234 0000 



0254 0000 



STACK 



DS 
OW 



44 




(Local Stack 
(CPU Stack sav« 



RS-232 Interface Routines 



0258 


C? 


OPMDErl 


RET 


0239 


C? 


1 

MRrlDEH 


RET 


02SA 


C9 


t 

CLMDEM 

1 

1 


RET 



Insert wour RS-232 code here. Your routines 
should restore all registers to their original 
values before returning. 



(Insert wour RS-232 port setup 
(here . 

(Insert the code to output a 
(a character to *our RS-232 
(here. Your routine should 
(include a status check. 

(Insert the code reouired to 
(shut off wour RS-232 »ort 
(before returning to CP/M here. 



0238 



/l %/ 

'* */ 

/* Print buffer prosran for %/ 

/* Heath H-8 »/ 

/* t/ 

/* Halt Piotrowski »/ 

/* State University of NY %/ 

/* Binahaatonr NY %/ 

/* % , 

/* %/ 



• include cprtbuf.cl 
•include sc80.cc 

•define bufsiz 15000 
♦define true 1 
•define false 

MAINO 
< 

char circbuf CbufsizJI 
int inptrrotptrf 
int inpofff 
char reccharl 

/* Initialize */ 

inset <)> 

otset OS 

inpoff « false! 

inptr - 0* 

otptr = 0> 

/* Main Loop */ 

while (true) 
< 



/* Circular buffer */ 
/* Buffer pointers */ 
/* Input CRTS) off flaa */ 
/* Received character */ 



/* Set up input USART */ 
/* Set up output USART */ 
/* Input is on */ 



/* Character Input */ 
if (rdwin ()) 

•Crecchar = chrin()» 

if (recchar •» 0) 

■Ccircbuf Cinptr++D ■ recchar»> 

if (inptr«=bufsiz) <inptr»0»> 

buffulK inptr rotPtr>tinpoff ) I 

> 

/* Character Output */ 

if (inptr !»otptr I rdwot< )*«true) 
•Cchrot (circbuf CotPtr++3)> 
if (otPtr—bufsiz) <otptr-0l> 



and we can make arrangements for 
giving you a copy of the entire 
program. 

An H-8 Printer Buffer 

My main machine, which will tran- 
smit to the printer buffer, uses what's 
been called an x-line protocol for RS-232 
transmission. It responds to Data Ter- 
minal Ready (DTR) and Request to 
Send (RTS) on the RS-232 line. Nor- 
mally, the DTR signal from the 
receiving device is controlled by hard- 
ware and is asserted whenever the 
power is on. The RTS line is 
manipulated dynamically by the 
receiver to control the data flow. The 
H-8 program, described later, uses this 
RTS line to shut off the data flow when 
the buffer memory is full. 

Slight hardware mods were needed 
to set DTR and RTS signals from the 
H8-5 board. All of the H-8's serial 
devices used a 3 line RS-232 interface, 
which does not provide control fun- 
ctions between the receiver and the 
sender. For some unknown reason, a 
great deal, but not all, of what was 
required to provide DTR and RTS 
signals was already on the board. The 
hardware mods provided at the end of 
the article will make sense if you have 
an H8-5 logic diagram in front of you. In 
essence, they do the following: 

1) Provide pullups for the collectors of 
the transistors that provide the DTR 
and RTS signals. 

2) Reverse the sense of the DTR signal 
so that it goes high when power is on. 

3) Provide a cable and back panel con- 
nector to get the additional RS-232 
signals from the H8-5 board onto an RS- 
232 cable. 

Listings for the H-8 print buffer 
program are provided along with this 
article. The program is in two parts. 
The control portion, written in Small C, 
contains an infinite loop which polls the 
input line for data and also polls the 
output line to see if it is ready to tran- 
smit another character. Since the input 
rate is higher than the output rate, the 
excess characters go into a circular buf 
fer. When the circular buffer is 
dangerously close to full, the program 
shuts off the input by dropping the RTS 
(Request to Send) signal on the input 
line. It turns the input back on again 
when there is more room in the buffer. 
The actual I/O to handle the H-8's 
USARTs is done with assembly 



buffull(inptr»otptr»linpoff)f 
> 



/* Buffer full check */ 
buf full ( inptr» otPtrrPinpof f ) 
int inptr»otptr»*pinpof f t 



int slotslftf 



/* Number of slots left %/ 



slotslft = otptr-inptr; 
if (slotslft <= 0) 

<slotslft = slotslft + bufsizJ 

> 
if ((slotslft < 20) 8 (*pinpoff == false)) 

<*pinpoff = true r 

trnof < ) i 

> 
if ((slotslft > 20) I (*pinpoff == true)) 

■C*pinpoff = false i 

trnon( ) » 

> 
> 
♦ asm 

H-8 Print Buffer Subroutines 
Walt Piotrowski 
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Input USART Eoustes 



INMOD 

INCMON 

INCMOFF 

INCTL 

INDATA 

INSTAT 

» 

i 

OUTMOD 

OUTCMD 

OUTCTL 

OUTDATA 

OUTSTAT 

i 

TXREDY 

RXREDY 

t 

TRUE 

FALSE 

i 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



116Q 
0640 
024Q 
371Q 
370Q 
371Q 



Output USART Eoustes 

EQU 116Q 

EQU 1 

EQU 377Q 

EQU 376Q 

EQU 377Q 



EQU 
EQU 

EQU 
EQU 



1 

1 




(Mode Inst 
JC»d RTS on 
iCmd RTS off 
^Control Port 
(Data Port 
JStatus Port 



'Mode Inst 
f Command Inst 
fControl Port 
rData Port 
JStatus Port 

JTX Ready Status Bit 
»RX Ready Status Bit 



Shut 


input off 




ZTRNOF MVI 


A, INCMOFF 


>G#t off coaaand 


OUT 


INCTL 


fScnd to USART 


RET 







Turn in^ut on 



QZTRNON MVI 
OUT 
RET 



A» INCMON 
INCTL 



I Get on co»Mnd 
I Send to USART 
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language subprograms. These are 
given in the third listing. 

By using Small C. it was possible to 
check out the control portion on the 
host by INCLUDEing a test library in 
place of the actual I/O routine library. 
Since I had never written a program in 
C before, this was an important con- 
sideration for me. When the program 
ran satisfactorily on the host, I tran- 
smitted it to the target with only the 
I/O left to be checked. 

H8-5 Hardware Mods 
Board Changes: 

1) Cut the solder trace from IC122 pin 1 
to IC 124 pin 23. 

2) Cut the solder trace from IC122 pin 3 
toBl54. 

3) Cut the solder trace from IC122 pin 6 
to R155. 

4) Connect IC122 pin 6 to IC122 pin 1. 

5) Connect IC122 pin 3 to R155 (same 
end as step 3). 

6) Connect IC124 pin 23 to IC117 pins 12 
and 13. 

7) Connect IC117 pin 11 to R154 (same 
end as step 2). 

8) Connect a 2200 ohm Vt watt resistor 
between P102 pin 9 and P102 pin 1. 

9) Connect a 2200 ohm Vi watt resistor 
between P102 pin 9 and P102 pin 2. 
Cables: 

The following signals at P102 on the 
H8-5 board need to be brought out to 
the back panel and from there to the 
RS-232 cable. The RS-232 connections 
shown assume that your host computer 
is wired as Data Terminal Equipment 
(DTE). 



Signal 

RTS 
DTK 
GND 
Data In 
Data Out 



P102 

Pinl 
Pin 2 
Pin 4 
Pin 5 
Pin 8 



Rt-232 

Pin 5 
Pin 20 
Pinl 
Pin 2 
Pin 3 



Connectors: 

The following connectors are those 

used by Heath: 

S102- 

Molex 22-01-2105 

G C Electronics 41-130 
Back Panel Connectors: 

Molex 03-06-2151 (plug) 

Molex 03-06-1151 (socket) 

Sold as a package by Waldon 1625-15 
PRT 



Miscellaneous Software 
Procedures 

To make a COM file from a HEX file 
that has been ORGed at 2040H use 
DDT with the following commands: 

iFN.HEX 

rEOCO 

If you are using Small C 1.1, which 
generates a file for ASM, you can make 



See if input ready 



QZRDYIN 


IN 

ANI 

JZ 

LXI 

RET 




INSTAT 
RXREDY 
RDYINl 
H,TRUE 


BtCPRTBUF.CL 




RDYINl 
1 


LXI 
RET 




H, FALSE 




See 


if 


output re 


QZRDYOT 

RDYOTl 
( 


IN 

ANI 

JZ 

LXI 

RET 

LXI 

RET 




OUTSTAT 
TXREDY 
RDYOTl 
HfTRUE 

H, FALSE 


i 
i 


Set 


UP 


input USA 


QZINSET 

» 

i 


MVI 
OUT 
RET 




Af INCHON 
INCTL 



Set up output USART 



QZOTSET 



OUTDLY 



MVI 
OUT 
MVI 
INR 
JNZ 
MVI 
OUT 
RET 



AfOUTHOD 

OUTCTL 

AtO 

A 

OUTDLY 

ArOUTCMD 

OUTCTL 



t — — 






t 






i Input 


a 


character 


( 






QZCHRIN IN 




INDATA 


MOV 




LfA 


MVI 




HfO 


RET 






( 

1 







a HEX file for your target machine by 
modifying the first few lines of the 
ASM file produced by the compiler. In 
the ASM file, change the ORG to the 
address appropriate for your machine 
(2040H in this case) and change the 
stack pointer setup to point to the top 
of your target's memory. 



(Get status 

(Mask 

10 ■ not readw 

(Char is ready 



(No char 



(Get status 

IMask 

JO = not ready 

(Ready for output 

I Not ready 



rCoftftand 

(Out to control port 



(Mode 

(Out to control port 

(Setup for wait loop 

r Increment 

(Wait for USART 

t Command 

(Out to control port 



IRead it 

(Low order of para* 

(Hi order 



Listing continued on page 14 



Tne CoT!Dute r jcw-ai 11 



PERSONAL ROBOTICS EXCLUSIVELY 

FACTORY AUTHORIZED DEALERS 



HAVE YOU HEARD ABOUT SAVVY? 
SAVVY is a revolutionary prog ram mmg language for the Apple ll + & lie and !he 

IBM PC n approaches artificial intelligence Besides being a perfect language for 
robot control, it can handle general applications programming Write or can for de- 
tailed descriptive material 



A FULL-LINE ROBOT SUPPLIER 

1 No dissatisfied customers 

2. Call if you have questions — we know our products 

3 Unlimited help when you need it. 



MOVIT 

Screwdriver Kits — No Solder — FUN 



A voider 
Circular 

Line Tracer 

Medusa 

Memoconcrawit 

Monkey 

Mr Bootsman 

Peppy 

Piper Mouse 

Sound Skipper 

Turn Backer 



4495 4015 

67 95 63 75 

39 95 36 75 

27 95 26 25 

74 95 70 15 

24 95 23.65 

30 95 29 25 

24 95 23 65 

4495 4013 

24.95 23.65 

39 95 36 75 

We nave sold hundreds of these items 

They work as they should and they 1**1 

HARVARD ASSOC. 

Turtle Tot 299.00 275 00 

Excellent tor simple educational appli- 
cations Our customers have been very 
satisfied 

ROBOT SHOP 

Robot Bug 129 95 122 00 

2-1 14995 136.50 

2-2 24995 22350 

Simple and dumb, but lots of potential 
tor customizing and expansion 



EEEEXS u$i sale 

AN0ROB0T 

Slave to your computer 
TOPOHI 1595 00 1485 00 

Accessories CALL 

TOPO in moves and talks very we" >t uses 
LOGO-hke commands and a good text- 
tospeech system 

RB ROBOT 

Download from your computer 
RB5X 2295 00 2058 X 

Accessories CALL 

Program it m Tiny BASIC Or use a SAVVY 
to Tiny BASIC "compiler" P.B5X has 
bumpers and sonar voice with souna ef 
tects. arm easy-to-use programming lan- 
guage, additional senses are available 
It is good Quality Our two demos have 
seen hard use and haven 't broken down 
yet' 

ARCTEC 

GEMINI 6995 00 6506 00 

A marvel Three CPUs voice recognition 
goahonented navigation onboard dis* 
drive, detachable keyboard and more 



TECHNICAL INFO-WE CAN HELP. CALL 



Shipping Over S200 Add 4% $200 And Under Add 5°= 

Cash With Order Deduct 3% N.M Orders Add 5% Sates Ta* 

Allow 4 Weeks For Delivery 

RIO GRANDE ROBOTICS"RG - 

A Division of Mobile Intelligence Corporation 

1595 W. Picacho #28, Las Cruces, N.M. 88005, Tel. (505) 524-9480 I 



RP/M 



T.M 



By the author of Hayden's "CP/M Revealed." 

New resident console processor RCP and new 
resident disk operating system RDOS replace CCP 
and BDOS without TPA size change. 

User files common to all users; user number 
visible in system prompt; file first extent size 
and user assignment displayed by DIR; cross-drive 
command file search; paged TYPE display with 
selectable page size. SUBMIT runs on any drive 
with multiple command files conditionally invoked 
by CALL. Automatic disk flaw processing isolates 
unuseable sectors. For high capacity disk systems 
RDOS can provide instantaneous directory access 
and delete redundant nondismountable disk logins. 
RPMPIP utility copies files, optionally prompts 
for confirmation during copy-all, compares files, 
archives large files to multiple floppy disks. 
RPMCEN and GETRPM self-install RP/M on any 
computer currently running CP/M e 2.2. Source 
program assembly listings of RCP and RDOS appear 
in the RP/M user's manual. 

RP/M manual with RPMCEN.COM and CETRPM.COM 
plus our RPMPIP.COM and other RP/M utilities on 
8"SSSD$75. Shipping $5 ($10nonUS). MC,VISA. 



ffl 



118 SW First St. - Box C 
Warrenton, OR. 97146 

icro • 

ethods, Inc. 

(503) 861-1765 



HERO /APPLE HANDSHAKE 



r-^W«S»- 



"Ousting the) source " 



ROBI. . .an affordable interface for 
the robotics experimenter. Easy 
hook-up (8 screws on HERO •, 1 
card slot on Apple * II or He) and a 
low price are combined with extra 
capabilities in the ROBI computer/ 
robot interface. 



$199.00! 



f*OBi SPECIFICATIONS 

• 4 programmable btOirect>ona B-b'i ports 

tor interface and expansion 

• programmable contro. ov *ene$ha*-*g 

• access fo a>gna<$ through fie M' b ' boc*s 

on robot s Exp+r,m*ma Boa r C 

• 6-/00' cafe tor int»r*ace lim-tea remote 

Operation 

• Utar-tnand'ySOtlwa'eQ^'Ckiy frj«s'e'S rit«s 

bmtwef eomputa? ara rcoot s'oresand 
retrieves /■'« to a*a tro** jj* 

• not copy protected Software <s provided -n 

DOS 3 3 
e tib+raitr commented towca code ■ncuQec 



BERSEARCH 

Information Services 

26160 Edelweiss Circle 
Evergreen. CO 80439 
(303) 674-0796 



APPLE ' rj a trad«Tijii o' *«>'• C<ynD-te- 
MEflO ' i» a tradamar* o* Haat* Etact'on.cs 
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BASE 

A Series on Mow To Design and Write Your Own Database 

By E.G. Brooner 



l^r e come now to the theoretical 
means that can be used to 'find' some 
particular bit of information or some 
related set of data items. Placing in- 
formation into some particular order 
and finding it again involves techniques 
generally summarized as sorting and 
searching. We are assuming that the in- 
formation has been originally stored in 
some random, un-ordered manner. 

Sorting, of course consists of placing 
the data in some kind of ascending or 
descending order, alphabetically or 
numerically. There is actually little dif- 
ference between the two in computer 
applications because sorting is based on 
the ASCII value of the characters - the 
ASCII value of the numeral '9' is larger 
than the value of the numeral '8,' and 
the value of 'B' is greater than 'A.' 

As we will probably enter data more 
or less haphazardly, as it comes to us, 
this sorting has to be done by the 
program after the data has been en- 
tered. It may have to be done again 
from time to time as more data is ad- 
ded. There are several interesting 
programming techniques used to ac- 
complish this end. 

Searching is also a diversified con- 
cept, and the means used depends on 
how the information is ordered and 
stored in the files. One technique we'll 
discuss is indexing, which is used 
almost exactly as the index is used in a 
book or catalog. Another is the ap- 
parently magical means of using the 
data itself as a clue to its location on the 
disk; this is known as 'hashing.' Binary 
searching is another method ideally 
suited to computer use, since it is based 
on the kind of logic computers use. 

The sequential search. Assume a list 
of names or numbers, which may or 
may not be in any particular order; 
assume then that you wish to locate one 
particular item. Your only choice is to 
start at the beginning and check each 
item until you find the correct one. This 
is JC. for a single printed page or for a 
data file of a few dozen items, but it can 



be time-consuming if the list is long. 
Many file programs use the sequential 
access method; it is simple and for some 
purposes is perfectly adequate. In some 
cases it is mandatory — in a database it 
is often necessary to find several en- 
tries that meet the same criteria, which 
means that the entire file has to be read 
to make sure none are missed. 

Sorted order. Next, consider that the 
list of names has been sorted into 
alphabetical order (as in a phone direc- 
tory or dictionary). We open the list and 
look at an entry; if we are looking for 
'Jones' and the list falls open to 



'Conrad' we know to look beyond that 
point. If it falls open to 'Smith' we flip 
back toward the beginning. Repeating 
this process narrows the search until 
we find the entry for which we are 
looking. This is the basis for the binary 
search we will discuss later. 

Direct addressing. Now consider a 
similar list that is numbered in sequen 
ce. If we know that the item we want is 
entry number 876 we can go directly to 
it. In effect this is what we frequently 
do with a data file, if and when we know 
which relatively numbered record it is 
that we want. If we are using a so-called 



REM 

REM 

REM 

5000 

REM 



REM HOW MANY RECORDS 
REM IN THIS FILE? 



REM LIST THE NAMES 
REM OF THE FIELDS 



5050 
5100 
REM 



REM 
REM 



REM 



REM 

5110 

5120 



Mtt*tt*tt(*ttS*tttttt( 

tSINGLE-SEARCH ROUTINE* 

ttttt*tt*tttttts>t**t*> 

GOSUB 9999 

DEFINE THE FILE STRUCTURE 

FILE*="B"*NAME«+".EXT" 

OPEN FILE* AS 16 

READ #16;EXT7. 

CLOSE 16 

F I LE*= " B " +NAME*+ " . DEF " 

NBR.OF.FLDS'/.=0 

OPEN FILE* AS 16 

FOR X7.= l TO 12 

IF END #16 THEN SOSO 

READ #16sFLD.NAME*,FLX(X7.> 

NBR . OF . FLDSX-NBR . OF . FLDS7.+ 1 

PRINT XXj TAB <5>;FLD. NAME* 

FIELD. NAME* (XX)-FLD. NAME* 
NEXT xr. 
CLOSE 16 

PRINT "TO TERMINATE SEARCH, ENTER • "; NBR. OF. FLDS7.+ 1 < PRINT 

INPUT "SEARCH ON FIELD NUMBER " J FLDX 

ANY FIELD CAN BE USED AS THE 'KEY' FOR SEARCHING 

IF FLD7.<1 THEN 5100 

IF FLDX> NBR.0F.FLDS7. THEN 1300 

INPUT "SEARCH-KEY (ANY « LEFTMOST CHAR OF FIELD » J KEY* 

K.LX-LEN(KEY») 

YOU CAN USE PART OF THE FIELD AS A KEY 

AND FIND AN EXACT MATCH, OR ALL GREATER OR LESS THAN KEY 

PRINT "RELATION OF RECORD TO KEY: 1-EQUAL TO" 

PRINT TAB(2B) ; "2-GREATER THAN" 

PRINT TAB(2B);"3=LESS THAN" 

INPUT RELX 

IF REL7.<1 OR REL7.>3 THEN 5100 

CREATE FILE NAME, OPEN IT, AND START LOOKING 

FILE*="B"+NAME*+STR*(FLD7.)*".DAT" 

OPEN FILE* RECL FL7. (FLD7.) +5 AS 16 

IF END #16 THEN 5200 

FOR N7.= l TO EXTV. 

READ #16; DATUM* 

DATUM*-LEFT* (DATUM*, K.L7.) 

ON REL7. GOTO 5110,5120,5130 
COMPARE RELEVANT PART OF FIELD W/CHOSEN RELATIONSHIP 

IF DATUM*-KEY* THEN 5140 

GOTO 5150 

IF DATUM* >KEY« THEN 5140 
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'random access' (or 'relative') file, the 
operating software keeps track of 
where each record is located and we 
simply ask for the record by number. 

Keyed access. Sorted order and 
direct addressing can be combined in a 
very useful way. If the records are 
numbered we can first sort the 'key' 
(names, in this example) and rearrange 
the record numbers in accordance with 
the alphabetical order of the names. 
Doing this results in a 'mixed-up' list of 
record numbers. Now if we read the 
records in the 'mixed-up' order we will 
find that the resulting list of names will 
come out in the sorted order. This will 
be illustrated when we get to the por- 
tion of BASE that does the actual sor- 
ting. 

This kind of arrangement has a par- 
ticular advantage for computer use. Af- 
ter sorting the record numbers as 
described, we store them as a separate 



list. This list is then known as a 'key 
file' or index file. The advantage is that 
the original list of names has not been 
altered in any way from its random or- 
der. But by referring to the key file we 
can go directly to the information as if 
it were in alphabetical order. 

Binary search. The technique just 
described does not, by itself, solve all 
problems. We still might need a quick 
way of leafing through the key file to 
find out which record number 
corresponds to the name 'Jones.' The 
binary search is one way to do so. A key 
file that is to be used in this way has to 
contain the key fields in their sorted 
order, along with their record numbers 
in whatever order they happen to be. 
The binary search process then looks at 
the key fields and uses the associated 
record number to find the complete 
record. 

The binary search only needs to 



5130 

REM 

5140 



5150 
5200 



REM 
6000 

7000 
8000 
REM 

REM 
REM 
REM 
REM 

9000 



GOTO 5150 

IF DATUM*<KEY* THEN 5140 

GOTO 5150 

WHEN KEY FOUND, GO READ ENTIRE RECORD 

F0UND'/.=N7. REM KEY MATCHES THIS RECORD 
PRINT "RECORD NUMBER "; FOUND - /.: PRINT 
GOSUB 9000 REM READ THE WHOLE RECORD 
IF CONTINUE*="M" THEN 5200 

NEXT NX 

CLOSE 16 

GOTO 5000 



SEARCH HAS ENDED 
CHAIN "FILES0RT.COM" 



REM IF OPTION CHOSEN 



REM 
REM 



9999 



REM 
REM 



CLOSE 17, 18: GOTO 1000 REM & START OVER 

CHAIN "PRTF0RM.COM" REM IF OPTION CHOSEN 

THE '.COM' EXTENSION IS USED ONLY IN THE CB-BO VERSION 

***t*tttt*ttttttt*t*ttt* 

*FIND AND READ FILE 'N't 
t*t*ttttt*ttt**tt*ttttt* 

SUBROUTINE CALLED BY SEARCH SECTION WHEN KEY FOUND 

FOR X7.= l TO NBR.OF.FLDSX 

F I LE*="B"+NAME«+STR»<X •/.>♦". DAT" 

OPEN FILE* RECL FLX < X7.) +5 AS XX 

READ »XV.,F0UND7.;DATA«(XV.) 

PRINT F I ELD. NAME* < XV.) ,DATA«<XV.) 
NEXT X7. 
FOR X'/.»l TO NBR.0F.FLDS7. 

CLOSE NK 
NEXT X7. 

PRINT "TYPE <CR> TO CONTINUE SEARCH OR <M> FOR MENU" 
WHEN THROUGH VIEWING THE DATA, PRESS RETURN TO CONTINUE 
SEARCH AND DISPLAY, OR 'M' TO END SEARCH 
INPUT LINE CONTINUE* 
RETURN 



PRINT CHR*(26) REM CLEAR SCREEN 

RETURN REM CHANGE FOR YOUR TERMINAL 

THE DATA STATEMENTS NECESSARY ONLY IN CB-BO VERSION 
WHICH HAS TO RESERVE DATA AREA FOR CHAINED PROGRAMS. 

DATA "A","B","C","D","E","F","G","H'V'J",»K",»L","M" 

END 



know the length of the file, or list, and 
whether it is in ascending or descen- 
ding order. It reads the key in the cen- 
ter, and learns whether the desired 
record is higher or lower in the order of 
things. It then examines the center of 
either the upper or lower half, as the 
case may be, and gets that much closer. 
About half a dozen 'looks' will find 
almost any entry in a list of a thousand 
or so items. Doubling the list's length 
only adds one more 'look,' and so on. 
The binary search is blindingly fast 
when using an in-memory array; it is 
quite impressive even when reading 
from a disk file. On the average, a 
binary search will find the desired 
record in 4 tries for a list of 25, 6 tries 
for 100, and 9 or 10 tries for a 1000 
record file. 2000 records needs 11 tries, 
5000 about 12 or 13, and 10000 only one 
more. Even searches of this magnitude, 
reading the records from a disk, take 
only a few seconds. 

In our database examples we will 
probably have to provide for more than 
one kind of search. We might, for 
example, sort the records for some kin- 
qs of access, and 'find' by relative ad- 
dress for others; at other times we 
might read the entire file sequentially 
and check every entry. It's obvious, 
then, that we will want to provide for 
more than one way of reading any par- 
ticular file or set of files. This will be 
explored more fully when we come to 
the sections of the program that ac- 
tually handle these chores. 

At this writing we have not added 
any of the more exotic methods of sor- 
ting and searching to the main BASE 
program, but they are worth describing 
and considering in the general context 
of database programming. As a matter 
of actual fact, the main body of BASE 
uses a simple sequential search, the op- 
tions being only to match a key, or find 
those either larger or smaller. For the 
latter two conditions a sequential sear- 
ch is a necessity anyway. 

The simple sort program that will be 
shown in another column builds key 
files consisting only of the record ad- 
dresses; this permits a file to be printed 
in ascending order baaed on any field. 
Two other programs are in existence 
that operate on BASE's files. One of 
these (called MATCH) allows us to mat- 
ch two fields, such aa first name and 
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telephone area code — i.e: Joe who lives 
in Seattle, area code 206.) The other 
(called BINARY) sorts selected files, as 
does the main program, but stores the 
keys in such a way as to provide a 
binary search which is part of the same 
program. If time and space permit, 
these auxiliary programs will be 
published at a later date. Keep in mind, 
though, that the portions of BASE 
shown to date, even without any sor- 
ting, can be very useful for modest-size 
databases. 

In BASE we have kept each field (of 
any set of records) as a separate 
file — this makes sequential searching 
(for a single field) quick and easy and 
simplifies using any field as 'key.' It 
also makes each of those mini-files easy 
to sort into a key file. Whether sorted 
or unsorted, the individual field in any 
field-file is inexorably related to the 
rest of its record by direct-addressing. 
Thus, we will be able to search such 
files at least three different ways and 
retrieve the remainder of the record af- 
ter the key is located. Since all fields 
can be 'key' in this system, your sear- 
ches can be as flexible as you wish to 
make them. 

The actual sorting of files for BASE 
has been kept a completely separate 
operation, and is in fact an auxiliary 
program that is 'chained' when we 
select that option from the main menu. 
The printing of reports is also a 
separate, chained program in this 
package. This was done to keep the 
program(s) small enough for a small 
memory, and to make the specialized 
sections easy to modify and/or ex- 
periment with. 

If you choose to combine the listings 
up to this point you will find that the 
source program runs around 400 lines 
and takes about 10K of filespace. When 



compiled with CB-80 it results in a 
machine language file of approximately 
18K. The sorting and printing 
programs are both considerably 
smaller. If you have to use the CRUN 
version, though, you will have less 
memory available because of the 
presence of the runtime program, so if 
memory is limited you might consider 
stopping here for awhile. 

How the Searching Goes 

Selective searches enable the user to 
extract different 'sub-sets' of infor- 
mation from a larger collection of data. 
All zip codes for Montana, for example, 
begin with 59; if I had several thousand 
subscribers in a mailing list I could ex- 
tract those in Montana by asking for 
any zip beginning with 59. This search 
could be narrowed to one particular 
distribution point (sub-area) by asking 
for 598, or 599, or the exact complete 
code could be used to pinpoint ad- 
dresses at a single post office. By the 
same reasoning one might want to list 
all customers having a given phone 
area code. One feature I included in my 
personal mailing list was a 'code' field. 
If the code is XC, that address is one to 
whom I send Christmas cards. Once a 
year, then, I can extract my card list 
from the hundreds of addresses I keep 
for other purposes. In my humble 
opinion being able to 'key-in' on any 
field, and to use partial keys, is essen- 
tial to database operation. 

The following section will work with 
the files that the earlier portions of the 
program created, regardless of 
whether the data has been sorted or 
not. It is a simple sequential search; 
however, it goes quite rapidly because 
only one field (of each record) need be 
read until the sought-for record is 
found. If we examine the basic sear- 



H-8 Print Buffer Subroutines, continued from page 10 
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1 

QZCHROT POP 
POP 
PUSH 
PUSH 
HOV 
OUT 
RET 

tendasa 


D 
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OUTDATA 


IGet return 
>Oet character 
(Fix stack 
IFix stack 
Unto A 
(Send it 
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ching routines of BASE (which follow), 
we will have looked at the entire main 
program. Keep in mind that they do not 
depend on the files being sorted, so you 
can actually run the program and get 
some use from it by combining the 
listings that were included in the 
earlier columns plus this one. Sorting 
and printing will be considered in 
future columns. If you wish, they can be 
completely omitted from the package, 
or you can design your own if ours don't 
fit your needs. Those that will be in- 
cluded in the package are kept simple 
for training purposes but have been 
adequate for most uses. 

The main function of the sort 
program that will be presented is to 
create and update key files. Once they 
are created they can be used in a 
variety of ways. 

In keeping with this program's 
design, a search first determines that 
the file(s) exists and 'learns' the struc- 
ture of its records. (Remember, there 
may be several mini-databases on the 
same disk, running from this one 
program.) You then choose which field 
to use as key, and which portion of it 
(for example, Z AN for ZANZIBAR), 
and specify that you wish to match the 
key, or see records greater or less than 
the key. You might, for example, 
specify 'less than ZZZ' to view the en- 
tire file. A recently added feature per- 
mits us to specify a range of values such 
as greater than A, and less than C, for 
example, to list all the existing entries 
that begin with B. Although it is not 
shown in this listing it can be added 
quite simply, since it is just a com- 
bination of the 'greater than' and 'less 
than' comparisons. 

When the key is found the entire 
record is read and displayed. You have 
the option of either continuing to 
look through the file or returning to 
the menu to proceed with another fun- 
ction. ■ 
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QUALITY SOFTWARE AT 
REASONABLE PRICES 

CP/M Software by 

Poor Person Software 
Poor Person's Spooler $49.95 

All the function of a hardware print buffer at a fraction of the 
cost. Keyboard control. Spools and prints simultaneously. 

Poor Person's Spread Sheet $29.95 

Flexible screen formats and BASIC-like language. Pre- 
programmed applications include Real Estate Evaluation. 

Poor Person's Spelling Checker $29.95 

Simple and fast! 33,000 word dictionary. Checks any CP/M 
text file. 

aMAZEing Game $29.95 

Arcade action for CP/M! Evade goblins and collect treasure. 

Crossword Game $39.95 

Teach spelling and build vocabulary. Fun and challenging. 

Mailing Label Printer $29.95 

Select and print labels in many formats. 

Window System $29.95 

Application control of independent virtual screens. 
All products require 56k CP/M 2.2 and are available on 8" IBM and 5" 
Northstar (ormats, other 5" formats add $5 handling charge. California 
residents include sales tax. 

Poor Person Software 

3721 Starr King Circle 

Palo Alto, CA 94306 

tel 415-493-3735 

CPM is a registered trademark of Digital Research 



FREE SOFTWARE 

RENT FROM THE PUBLIC DOMAIN! 

User Group Software Isn't copyrighted, so there are no fees to 
payl 1000's of CP/M and IBM software programs In .COM and 
source code to copy yourselfl Games, business, utilities! All 
FREEI 

CP/M USERS QROUP LIBRARY 

Volumes 1-92, 46 disks rental— $45 

SIQ/M USERS QROUP LIBRARY 

Volumes 1-90, 46 disks rental— $45 

Volumes 91-176, 44 disks rental— $50 

SPECIAL! Rent all SIQ/M volumes for $90 

K.U.Q. (Charlottesville) 25 Volumes-$25 

IBM PC-SIO (PC-DOS) LIBRARY 

Volumes 1-200, SV* " disks $200 

174 FORMATS AVAILABLE! SPECIFY. 

Public Domain User Group Catalog Disk $5 pp. (CP/M only) 
(payment In advance, please). Rental Is for 7 days after receipt, 
3 days grace to return. Use credit card, no disk deposit. 
Shipping, handling & Insurance— $7.50 per library. 
(619) 9144926 Information's) 
(619) 727-1016 anytime order machine 
Have your credit card readyl VISA, MasterCard, Am. Exp. 

Public Domain Software Centtr 

1533 Avohlll Dr. 
Vista, CA 92083 




THE SINGLE BEST 



FOR CP/M-80. 

A TRULY AMAZING 

PRODUCT." 

Compie'e upward compatibility wiir DDT 

Simultaneous instruction reg'Ster stack & 

memory displays 

Software In Circuit-Emulator provides wr.ie 

protected memory execute only code and 

slack protection 

Full Z80 support with Intel or Z<log Mnemonics 

Thirty day money back guarantee 

On line heip & 50 page user manual 



P.O. BOX 4M73 AUSTIN, TEXAS 7S7M (SI 2) 47S-47U 




"...received my moneys worth with /usf one 
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FAX-64: Facsimile Pictures on a Micro 

by Michael J. Keryan 



O evera] years ago. most home com- 
puters were owned by "hackers." These 
people knew how every integrated cir- 
cuit in their computer worked and they 
could explain every byte of the code in 
their computer's operating system. 
Although there are probably just as 
many hackers around today, there are a 
lot more owners of home computers 
classified as "users." Due to the rapid 
advancement in software, you no longer 
have to be a computer genius to use a 
computer. The most popular uses for 
home computers now include games, 
word processing, spreadsheets, 
education, and graphics. Graphic sof- 
tware packages for home computers 
like the Commodore 64 are becoming 
more and more powerful. 

To create your own masterpiece of 
art with a graphic input device such as 
a joystick, light pen, track-ball, or 
graphic tablet can take several hours 
and the results are highly dependent on 
your talent as an artist. Suppose you 
would like to include a more realistic 
picture of you, a relative, or a pet in a 
Basic program you are writing. If you 
' lack the artistic talent to draw these 
pictures, all is not lost. You can input 
pictures to your computer through an 
electronic scanning device. 

In this article, I'll describe the inter- 
face for a machine that can read any 
picture from a piece of paper and tran- 
slate the picture to signals that your 
computer can handle. The machine is a 
facsimile machine, commonly referred 
to as FAX. 



What is a FAX? 

The facsimile machine is quite com- 
mon in the business world. It is used to 
transfer a page of information (usually 
8 V. by 11 inches) over the phone line. 
At the transmitting end, a sheet of 
paper with text, graphics, or whatever, 
is fed into the machine. After a few 
minutes of whirring sounds, the paper 
comes back out of the machine. At the 
receiving end, the page image is recon- 
structed on a thermal printing device. 



The two FAX machines are connected 
to each other by modems in very much 
the same way that two computers 
communicate over phone lines. 

FAX machines have been used to 
transmit both text and graphics. With 
the advent of low cost computers, 
however, it is now becoming quicker 
and cheaper to send text from one point 
to another by purely digital means. 
FAX machines are still popular and will 
always be used for special applications 
(AT&T still says a FAX is the only way 
to transmit hand-drawings, signed legal 
documents, etc.), but more and more 
companies are replacing their FAX 
networks with computer networks for 
text transmission. 

The result of this change-over in 
technology is that businesses are now 
dumping used FAX machines into the 
surplus market. These machines, which 
cost up to $4000 new, can now be ob- 
tained for less than $200. Used FAXs in 
good working condition are quite a 
bargain and can be obtained from 
dealers of used office equipment and 
large electronic/computer surplus 
dealers. 



Some Facts about FAX 

A FAX machine is actually two 
machines in one. The transmitter feeds 
in a sheet of paper, scans it, translates 
the image to an electrical signal, 
modulates the signal, and sends it over 
a telephone line. This is the part we're 
interested in. The receiver takes the 
telephone signal, demodulates it, and 
translates the electrical signal to an 
image on a fresh piece of paper. We are 
not interested in the receiver end, 
although it can be used for a very slow, 
low quality printer. (Note - in most 
FAX machines, looping the output 
signal of the transmitter to the input of 
the receiver will turn the machine into 
a copying machine.) 

There are probably just as many 
FAX "standards" as there are com- 
panies that make the machines. The 
signal can be amplitude modulated by a 



carrier of constant frequency, or it can 
be frequency modulated, giving a con- 
stant amplitude saw-tooth signal in 
which the frequency varies with 
brightness level of the scan. The signal 
can be digital in nature (only two levels- 
black and white; commonly used for 
text), or the signal can be analog, in 
which an infinite variation in gray 
levels are possible. An analog type 
signal is required for pictures. Various 
scan rates are used, from a fast 5 scan 
lines per second to 2 scans per second. 
In addition, the vertical resolution can 
vary from about 80 to over 200 scan 
lines per inch. 

For our purposes, what standard 
should be used? Since the primary pur 
pose is to digitize pictures, we will need 
an analog signal. Since most home com- 
puters can easily keep up with the scan 
rates involved by using machine 
language routines, we should use the 
fastest scan rate available. Another 
consideration is deciding between AM 
versus FM signal modulation. FM will 
reduce the amount of noise in the pic- 
ture, but a few pixels of noise are not 
really noticeable in a digitized picture. 
Luckily, the machine I obtained had a 
multitude of switches that could be 
used for just about any standard. The 
machine is a Burroughs DEX 4100, 
which I currently have set up in the 
following mode: 

Machine DEX mode 

Speed High 

Re s Norm 

ResX2 Off 

TX Level Norm 

°oc Photo 

Simplex On 

The resulting output is an amplitude 
modulated signal with a carrier 
frequency of 1920Hz. The peak-to-peak 
signal varies from approximately 1 volt 
(black) to nearly volts (white). The 
scan rate is exactly 5 Hz, giving 88 scan 
lines per inch. An entire 11 inch long 
sheet of paper is scanned by ap- 
proximately 955 lines in a little over 
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three minutes. 

The hardware and software presen- 
ted in this article will work with a DEX 
4100 FAX machine connected to a 
Commodore 64 computer. Other FAX 
machines, other transmission standards, 
and other 6502 computers can be 
used. However, other equipment will 
require revisions in the machine 
language software and possibly in the 
interface circuitry as well. But the 
techniques shown can be used as a star- 
ting point for any other configuration. 

Some Design Considerations 

Before jumping into the hardware 
and software design, let's think about 
how we will use the machine with our 
C-64. In the mode I chose to use, the 
FAX can digitize graphics at a 
resolution of over 50 dots/inch horizon- 
tally (along a scan line) and over 80 
dots/inch vertically (from line to line). 
The most important criteria is that the 
aspect ratio of a picture is unchanged. 
A circle on the original should still look 
like a circle on the digitized image; it 
should not look like an oval. Another 
nice-to-have feature is that the picture 
will not have to be rotated 90 degrees 
to look at it. Most 8 Vi by 11 or 8 x 10 
pictures are oriented vertically (like the 
page you are now reading); this means 
that we would only use about half the 
page. The C-64's graphic resolution is 
320 horizontal, 200 vertical. 320 dots 
with about 50 dots/inch gives a little 
over 6 inches out of the total 8 or 8V« 
inch picture width. This is acceptable 
because the important picture content 
is almost always near the center. Due 
to the C-64 aspect ratio, the height of 
the digitized image on the original is a 
little over 4 inches. The FAX's vertical 
resolution is twice what we need, so 
we'll plan on using only every other 
scan line. 

If you've been keeping up on the C-64 
graphic articles, you know that there 
are two distinct bit-mapped modes: 
HIRES with 320 x 200 pixels and two 
colors, and MULTI with 160 x 200 
pixels and four colors. Actually, the two 
or four color restrictions pertain to an 
8x8 grid of dots and other 8x8 grids 
can have other color combinations. But 
since the scanning and digitization will 
be completely automatic, it is much 
simpler to restrict our pictures to two 
colors in HIRES mode and four colors 




This example of an image produced by FAX-64 has been reduced from the printout size of V/i x 9 



in MULTI mode. However, we won't 
restrict our colors to black, white, and 
shades of gray. It is very desirable to be 
able to choose any color we want for 
any level of intensity. 

Another feature that we would like 
to have is the ability to control where 
the top of the picture should be, by use 
of the keyboard. After the picture has 
been transferred to the computer and is 
displayed on the screen, we would like 
to save it to a disk file in a format that 
is compatible with other graphic aid 
and graphic print programs. This way, 
we can further enhance the pictures 
and get hard copies of them. 

FAX to C-64 Interface 

The signal coming out of the FAX is a 
relatively low voltage modulated 
analog signal. The interface must am- 
plify the signal, demodulate it, and con- 
vert it to a digital signal (D/A conver- 
ter). The extremely simple circuit I 
came up with, ahown in Figure 1, will do 
all the required signal conversions.The 
five volt power supply in the Com- 
modore 64 is used to power the inter- 
face. The signal coming from the FAX 
is divided by a 50Kohm potentiometer. 
This functions as a brightness control. 
The reduced signal is amplified by Al, 



one quarter of a low cost quad op-amp 
(IC1: LM3900). The output of Al is in- 
verted by A2. The outputs of both Al 
and A2 are summed through diodes by 
A3, which acts as a full wave rectifier 
and demodulator. A4 inverts the signal 
and buffers it. The output of A4 varies 
from about two to four volts, in direct 
proportion to the brightness of the 
FAX scan at that instant. 

IC2 (LM 339) is a quad comparator. 
A5, A6, and A7 are set to switch at 
about 3.75, 3.12, and 2.5 volts, respec- 
tively. The output of A4 is fed to all 
three comparators, which digitize the 
signal into four distinct levels from 
dark black to bright white. The com- 
parator outputs are connected directly 
to three I/O bits of one of the C-64's CIA 
chips, through the USER port. (For 
computers other than the C-64, any PIA 
type I/O port could be used: 6820, 6821, 
6520, 6522, etc.) The software driver 
will convert the three bits to a two bit 
binary code to signify gray level. For 
other computers that can display more 
gray levels, a more sophisticated 
analog to digital conversion would be 
required. But for the C-64 (and most 
inexpensive home computers), four 
distinct gray levels are most ap- 
propriate. 
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The capacitor attached to A3 
demodulates the signal by filtering out 
the higher frequency carrier. The value 
ahown results in a good compromise of 
low noise and acceptable resolution. 
For other standards, you may desire to 
change the capacitor values. If the 
horizontal resolution is found to be less 
than desired, reduce this value. If the 
output has too many light to dark tran- 
sitions, smooth it out by increasing the 
value of the capacitor. 

The required cost of the interface is 
almost ridiculously low. The connector 
that attaches to the C-64 is the most 
expensive part (about $4.00). Any type 
of layout is probably O.K., since fairly 
low frequencies are involved. Use 
shielded cable to the FAX machine 
(shield grounded). The most desirable 
configuration is to connect the PC 
board to the C-64 connector, so that the 
whole unit can plug into the computer's 
USER port. 

Synchronization of the Signal 

The translation of the signal from 
analog to digital was pretty straight- 
forward. But at this point, a good 
question is "How in the world do you 
synchronize this signal to the com- 
puter?" This proved to be the most dif- 
ficult aspect of the project. Initially, I 
used a very stable crystal controlled 
clock and divider chain. It was im- 
possible to adjust the timing so that the 
image was stationary on the screen. A 
vertical line from the FAX would drift 
as much as 10 to 12 pixels to the left or 
right on the screen image. Next, I tried 
a phase lock loop oscillator, syn- 
chronized to the power line (60Hz). This 
was even worse; the vertical line ended 
up somewhat sinusoidal. 

I tried to use the modulation 
frequency of the FAX itself (1920Hz), 
but this oddball frequency was not ac- 
ceptable. It required a conversion to 
another frequency and a phase locked 
loop, since on white scenes, the 
modulated signal dropped to zero. This 
technique proved to be overkill and 
needlessly complex. 

Another way to do it is to lock onto 
the picture signal itself with software. 
A representation of the demodulated 
signal (the output of A4) is shown in 
Figure 2. If an 8Vi inch piece of paper is 
centered in the machine, the scan will 
give black guard bands off the edges. 
Between these black bands is a white 
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Figure 1 interface Schematic 
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sync pulse. Since the scan rate is con- 
stant (1 scan line every 0.2 seconds), the 
width of the sync pulse is constant. I 
decided to use the white sync pulse, 
followed by the black guard band, to 
sync the picture. This proved to be very 
stable, the only noticable by-product 
being a plus or minus one pixel uncer- 
tainty. Since I use the FAX mostly for 
pictures, this one pixel uncertainty is 
usually undetectable. 
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Figure 1: Modulated signal (output of A4) 



The dot clock was generated by sof- 
tware. By doing so much in software, 
we have significantly reduced the com- 
pexity and cost of the interface. That's 
the good news. The bad news is, of 
course, that the software required to 
support the hardware is quite complex. 

So far, we learned how a facsimile 
machine (FAX) works and we looked at 
a simple interface circuit that can be 
used to connect a FAX machine to a 
home computer, such as a Commodore 
64. Before jumping into the software, 
an overview of the operation is helpful. 

The CIA integrated circuit (6526) in 
the C-64 is used as a parallel input port 
to accept three bits of digitized infor- 
mation from the interface circuit. In a 
completely different application, the 
timer in the CIA is used as a clock 
signal. The clock is used to generate 
Non-Maskable Interrupts (NMD at a 
frequency of approximately 3000Hz. 
During a scanning operation, everytime 
a NMI occours, data is sampled from 
the input port, converted to a pixel (pic- 
ture element), and stored in graphic 
memory. Since this operation happens 
in the background, we can have a Basic 
program and even another machine 
language program running at the same 
time. This foreground/background 
mode of operation greatly simplifies 
the programming. 



89826 


4586 


48 




RTI 


;NO, IGNORE IT 


88827 


4587 


48 


SAVREG PHA 




88828 


4588 


8A 




TXA 




88829 


4589 


48 




PHA 




88838 


458A 


98 




TYA 




88831 


458B 


48 




PHA 




88832 


458C 


EE F8 46 




INC COLMTL 


;ADD 1 TO 


88833 


458F 


D8 8 3 




BNE N8 


; COUNTERS 


88834 


451 1 


EE F9 46 




INC COUNTH 




88835 


4514 


EE FA 46 


N0 


INC C0UNT8 


JC0UNT8 COUNTS 


88836 


4517 


AD FA 46 




LDA C0UNT8 


; PULSES BY 8 


88837 


451A 


C9 88 




CMP «*88 


;WHEN m 8 


88838 


45 1C 


D0 08 




BNE SYNC 


i COLUMN COUNT 


88839 


451E 


A9 86 




LDA MSB)) 


; IS INCREMENTED 


88848 


4520 


8D FA 46 




STA C0LMT8 




88841 


4523 


EE FC 46 




INC COLUMN 




88842 


4526 










88843 


4526 




; SYNCFLG IS A FLAG 


TO DENOTE 


88844 


4526 




; STATE OF SYNCHRONIZATION: 


88845 


4526 




; = 


128 OR HIGHER 


— IN SYNC 


88846 


4526 




i 


1 TO 127 — PHASING MODE 


88847 


4526 




; = 


6 -- OUT OF PHASE 


88848 


4526 










88849 


4526 


AD FF 46 


SYNC 


LDA SYNCFL 


J IS FLAG > 127? 


88858 


4529 


38 58 




BMI Nl 


;YES, PHASED 


88851 


452B 


D8 42 




BNE LOCKED 


;NO, LOCKING? 


88852 


452D 


AD 8 1 DD 




LDA DATAIN 


;NO, LETS GET 


88053 


4538 


29 8 7 




AND #*87 


;IN PHASE THEN 


88854 


4532 


C9 87 




CMP #*8 7 


;DATA = BLACK' 


88855 


4534 


F6 14 




BEQ LASTBL 


JYES 


88656 


4S36 


A5 FC 




LDA TEMPEV 


;NO, WAS LAST 


88857 


4538 


C? 87 




CMP #*8 7 


J ONE BLACK? 


88858 


453A 


F8 85 




BEQ ZWHT 


jYES, 


88859 


453C 


E6 FB 




INC TEMP 


;NO, MORE WHITE 


88868 


453E 


4C 88 45 




JMP LRT 




88861 


4541 


A9 6 1 


ZWHT 


LDA #*8 1 




88862 


4543 


85 FB 




STA TEMP 


; 1 WHITE 


88863 


4545 


85 FC 




STA TEMPER 


;LAST = WHITE 


88864 


4547 


4C 86 45 




JMP LRT 




88865 


454A 


A5 FC 


LASTBL 


LDA TEMPEV 


;LAST DATA 


88866 


454C 


C9 87 




CMP #*8 7 


;WAS IT BLACK? 


88867 


454E 


D8 6B 




BNE CHKWH 


;NO, 


88868 


4558 


A9 68 


WHZERC 


LDA #*ee 


;YES ZERO WHITE 


88869 


4552 


85 FB 




STA TEMP 


[COUNTER 


88878 


4554 


A9 87 




LDA #«8 7 


iMAKE LAST ONE 


88871 


4556 


85 FC 




STA TEMPER 


i BLACK 


88872 


4558 


4C 86 45 




JMP LRT 




88873 


455B 


A5 FB 


CHKWH 


LDA TEMP 


;WHITE COUNTER 


88874 


455D 


C9 4C 




CMP #76 


i <76? 


88875 


455F 


98 EF 




BCC WHZERO 


;YES, WAIT 


88876 


4561 


C9 58 




CMP #88 


; >79? 


88877 


4563 


B8 EB 




8CS WHZERO 


;YES, PAST IT 


88878 


4565 


A9 65 




LDA #18 1 


jA HIT! NOW 


88879 


4567 


8D FF 46 




STA SYNCFL 


J SET TO LOCKED 


88888 


456A 


85 FB 




STA TEMP 


i COUNT FROM 48 


88881 


456C 


4C 88 45 




JMP LRT 




88882 


456F 


C6 FB 


LOCKED 


DEC TEMP 


;IS COUNTER DOWN 


88883 


4571 


D8 8D 




BNE LRT 


;TO ZERO? 


88884 


4573 


A9 FF 




LDA #*FF 


;YES, SET SYNCFL 


88885 


4575 


8D FF 46 




STA SYNCFL 


;TO SCAN 


88886 


4578 


A9 FF 




LDA #*FF 


i RESET COUNTERS 


86887 


457A 


8D FB 46 




STA LINE 


; THROUGH CODE 


88888 


457D 


4C C4 45 




JMP N2 


! AT N2 


0888? 


4588 


4C F2 46 


LRT 


JMP RETURN 




88698 


4583 


AD F9 46 


Nl 


LDA COUNTH 




88891 


4586 


C9 64 




CMP #*84 


;HI BYTE <4? 


88892 


4588 


96 6B 




BCC N4 


jYES, BRANCH 


88893 


458A 


AD F8 46 




LDA COUNTL 




88694 


458D 


C9 B6 




CMP H«B6 


;C0UNT>1 199? 


88895 


458F 


B6 33 




BCS N2 


J YES, MAX COUNT 


88896 


4591 


C? 45 


KSYNC 


CMP #69 


J IS COUNTER 


88897 


4593 


98 2C 




BCC KRT 


iWITHIN LIMITS? 


68898 


4595 


C9 51 




CMP #81 




88899 


4597 


B8 28 




BCS KRT 




88188 


4599 


AD 86 47 




LDA CHKSFL 


{SHOULD WE 


eeiei 


459C 


D6 23 




BNE KRT 


; CHECK FOR SYNC? 


86182 


459E 


AD 61 DD 




LDA DATAIN 


|YES, GET DATA 


86163 


45A1 


29 67 




AND #»6 7 




88184 


45A3 


C9 62 




CMP #»62 


; I S IT DARK? 


86185 


45A5 


B8 67 




BCS Kl 


jYES 


88186 


45A7 


A9 61 




LDA #«8 1 


(NO, MAKE LAST 


88187 


45A? 


85 FC 




STA TEMPEV 


jLIGHT 


68188 


45AB 


4C CI 45 




JMP KRT 





20 The Computer Journa> 



Machine Langauage FAX 
Driver 

The assembler code for the machine 
language program is shown in Listing 1. 
The first thing to describe is the new 
NMI routine. The pointers for this 
routine are poked into memory and ac 
tivated by a Basic program described 
later. NEWNMI first checks to see if 
the NMI actually came from the CIA 
chip. If so, all registers are saved. The 
program counts each NMI (each dot) by 
eight because eight dots make up a byte 
of screen data. 

A flag is used to denote the state of 
synchronization. If the flag is (initial 
state), the signal is out of sync. If the 
flag is between 1 and 127, the program 
goes into a special phasing mode. If 
>127, the flag denotes that sync is 
established. We'll look at each sync 
mode separately. 

If out of sync, the program will look 
for a string of white bytes that are 
between 76 to 80 dots wide. This string 
must be bounded on both sides by black 
dots. If any dot is out of sequence, this 
routine will reset and continue to look 
for this sequence. This white area is the 
sync pulse described previously. The 
length (76-80 dots) is dependent on the 
machine scan speed and software timer 
period. Any change in these will 
require a new window size. Once the 
sync pulse is found, the program 
changes the sync flag so that operation 
will go to the special phasing Mode 
(LOCKED). A count of 101 is stored into 
a counter which is decremented by each 
NMI (each dot). At this point, the 
correct phase is established, and we are 
at the left margin of a picture. The flag 
is then changed to denote that sync is 
established and counters are zeroed for 
the vertical line number, the horizontal 
count, and the horizontal byte number 
(column). 

If the NMI routine is entered while 
in sync, it first checks to see if 1200 dots 
have occurred. If so, then one complete 
scan line (actually two physical scans 
since we ignore alternate scan data) is 
completed and we are then at the end of 
a line. We use this opportunity to check 
the keyboard for the 'T' key. T is 
pressed when you want the picture 
started at the top again, so the line 
number is zeroed. At the end of the 
200th line, the picture is complete, so 
the routine kills itself by disabling FAX 
interrupts (see N3). 
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881 15 


45BB 


8D 


F8 


46 




STA 


C0UNTL j 


A COMMON POINT 


881 16 


45BE 


8D 


86 


47 




STA 


CHKSFL | 


SET FLAG 


881 17 


45C1 


4C 


F2 


46 


KRT 


JMP 


RETURN 




881 18 


45C4 


A9 


86 




N2 


LDA 


**ee ; 


ZERO OUT 


eei 19 


45C6 


8D 


F8 


46 




STA 


CGUNTL j 


COUNTERS 


88128 


45C9 


8D 


F9 


46 




STA 


C0UNTH 




ee 121 


45CC 


8D 


FA 


46 




STA 


COUNTS 




ee 122 


45CF 


8D 


FC 


46 




STA 


COLUMN 




eei23 


45D2 


80 


68 


47 




STA 


CHKSFL 




eei24 


45D5 


EE 


FB 


46 




INC 


LINE ; 


GO DOWN 1 LINE 


88125 


45D8 


AD 


FB 


46 




LDA 


LINE 




ee 126 


45DB 


C9 


C8 






CMP 


*286 j 


LINES> 199' 


68127 


45DD 


B6 


BE 






BCS 


N3 j 


YES, BRANCH 


ee 128 


45DF 


A5 


C5 






LDA 


*C5 ( 


CURRENT KEY 


ee 129 


45E1 


C9 


16 






CMP 


M22 i 


IS IT 'T' 


eei3e 


45E3 


D8 


65 






BNE 


NRT ; 


FOR 'TOP"' 


88131 


45E5 


A9 


66 






LDA 


KS86 ; 


YES, START AT 


88 132 


45E7 


8D 


FB 


46 




STA 


LINE ; 


TOP 


88 133 


45EA 


4C 


27 


46 


NRT 


JMP 


ACTIVE ; 


NO, START LINE 


68 134 


45ED 


A9 


7F 




N3 


LDA 


#*7F ; 


DISABLE FAX 


ee 135 


45EF 


8D 


eo 


DO 




STA 


ICR i 


INTERRUPTS 


eei36 


45F2 


4C 


F2 


46 




JMP 


RETURN j 


FOR NOW 


88137 


45F5 


C9 


ei 




N4 


CMP 


tt*6 1 ; 


HI BYTE <1? 


88133 


45F7 


99 


2E 






BCC 


ACTIVE ; 


YES, SCREEN 


88139 


45F9 


C9 


B2 






CMP 


t»*6 2 ; 


>1? 


88 148 


45FB 


B8 


87 






BCS 


N5 ; 


IF SO, IGNORE 


ee 141 


45FD 


AD 


F8 


46 




LDA 


COUNTL 




ee 142 


4668 


C9 


48 






CMP 


ft* 46 ; 


COUNT <*6 140? 


ee 143 


4682 


90 


23 






BCC 


ACTIVE , 


YES, SCREEN 


88144 


4684 


A5 


C5 




N5 


LDA 


*C5 ; 


CURRENT KEY 


88145 


4666 


C9 


BD 






CMP 


ttl3 


IS IT 'S' FOR 


88146 


4668 


00 


1A 






BNE 


N6 ; 


'SYNC? 


88 147 


466A 


A9 


ee 






LDA 


»*ee 


RESTART ALL 


88 148 


466C 


8D 


FF 


46 




STA 


SYNCFL 




88149 


468F 


8D 


88 


47 


NSTART 


STA 


CHKSFL 




88158 


4612 


8D 


F8 


46 




STA 


COUNTL 




88 151 


4615 


8D 


F9 


46 




STA 


COUNTH 




88152 


4618 


8D 


FA 


46 




STA 


C0UNT8 




88153 


461B 


8D 


FB 


46 




STA 


LINE 




Be 154 


461E 


8D 


FC 


46 




STA 


COLUMN 




88 155 


4621 


4C 


58 


45 




JMP 


WHZERO 




Be 156 


4624 


4C 


F2 


46 


N6 


JMP 


RETURN j 


IGNORE PULSE 


88157 


4627 
















88158 


4627 








j IN THE ACTIVE SCAN AREA, FIRST 


ee 159 


4627 








; CHANGE THE 3 BIT DATA TO A TWO 


ee 168 


4627 








; BIT 


BINARY CODE. THEN SAVE ODD 


88161 


4627 








i DATA AND COMBINE THEM WITH EVEN 


B8 162 


4627 








i DATA SAMPLES. WHEN IN MULT I - 


88163 


4627 








i COLOR MODE, AVERAGE THE TWO. 


88 164 


4627 
















88 165 


4627 


AD 


81 


DD 


ACTIVE 


LDA 


DATA IN 


GET DATA 


88166 


462A 


29 


87 






AND 


t»*8 7 


MASK FOR 3 BITS 


88 167 


462C 


C9 


82 






CMP 


M82 


DATA <2? 


88 168 


462E 


98 


8A 






BCC 


TWOB I T 


YES, 6 OR 1 OK 


88 169 


4638 


C9 


84 






CMP 


H*84 


>3? 


88178 


4632 


Be 


84 






BCS 


WHITE 


YES, BRIGHTEST 


88171 


4634 


A9 


82 






LDA 


N*82 


LEVEL » 2 


88172 


4636 


D8 


82 






BNE 


TWOBIT 




88 173 


4638 


A9 


83 




WHITE 


LDA 


t»»83 


LEVEL - 3 


88174 


463A 


85 


FB 




TWOBIT 


STA 


TEMP 


SAVE DATA 


88 175 


463C 


AD 


F8 


46 




LDA 


COUNTL 


IS COUNTER 


88 176 


463F 


29 


81 






AND 


ti«e 1 


EVEN OR ODD- 5 


88 177 


4641 


06 


87 






BNE 


ODD ► 


BRANCH ON ODD 


88 178 


4643 


A5 


FB 






LDA 


TEMP 


, IF EVEN THEN 
SAVE TTLL NEXT 


88 179 


4645 


85 


FC 






STA 


TEMPEV 


88188 


4647 


4C 


F2 


46 




JMP 


RETURN 


;T1ME <0DD) 


88181 


464A 


AD 


81 


47 


000 


LDA 


MODE 


MULTICOLOR OR 


88182 


4640 


F6 


89 






BEO 


HIRES 


;HIRES MODE' 


88 183 


464F 


A5 


FB 




MULT I 


LDA 


TEMP 


jMULTI MODE 


88 184 


4651 


18 








CLC 




[HERE, WE'LL 


88 185 


4652 


65 


FC 






ADC 


TEMPEV 


[AVERAGE TWO 


88 186 


4654 


4A 








LSR 


A 


(CONSECUTIVE 


88187 


4655 


4C 


63 


46 




JMP 


CALCBT 


I BYTES 


88 188 


4658 


A5 


FC 




HIRES 


LDA 


TEMPEV 


; HI RES MODE 


68 189 


465A 


29 


62 






AND 


NS82 


i PLACE THE TWO 


88 198 


465C 


85 


FC 






STA 


TEMPEV 


jBITS IN THE 


68191 


465E 


A5 


FB 






LDA 


TEMP 


i CORRECT ORDER 


86 192 


4668 


4A 








LSR 


A 


((PRIOR « HIGH 
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During the 'dead' part of the scan, 
which is the physical scan line that we 
ignore, the keyboard is looked at again, 
this time for the 'S' key. On very rare 
occasions, a glitch may destroy the syn- 
chronization. The S key is used to start 
everything over again to re-establish 
sync. 

If the sync is established, and we are 
in the active scan area (dots to 319), 
the program jumps to ACTIVE. Here 
the data is sampled from the three in- 
put lines and converted to a two bit 
binary code: 00, 01, 10, or 11. Next, the 
mode of operation is looked at. If we are 
in HIRES mode, then we only want two 
levels of intensity for each dot. If the 
MULTIcolor mode is desired, then we 
will look at two consecutive dots, 
average them, and give the correspon- 
ding two-bit code for the average inten- 
sity level of the two dots. In either case, 
two bits are used to update the screen 
in the active scan area. 

The addresses for the bit-map area 
are determined from a set of lookup 
tables (see Listing 2). These addresses 
are constructed based on the vertical 
line number (0-199) and the horizontal 
column number (0-39). The new two bits 
are placed at the correct bit locations 
into the byte of data, and this byte is 
stored back in the 8K bit map memory 
area. Since there are four possible 
places to put these two bits, there are 
four small routines for this: B0, B2, B4, 
and B6. 

You can see that the NMI routine ac- 
tually does quite a bit. It handles all the 
synchronization of the FAX, inputs the 
scan data, checks the keyboard for S or 
T keys, keeps track of the screen 
locations, and handles all the screen 
writing in either HIRES or MULTI 
modes. 

Other Machine Language 
Utilities 

Listing 1 also shows a few more 
utility programs. These are not part of 
the FAX driver but are instead called 
by SYS statements from our Basic 
program. First is a routine to clear the 
8K bit-map area of memory. Also in- 
cluded are routines to clear the IK 
areas for the screen and color memory. 
Actually, with a POKE from Basic, 
these routines can change the colors to 
any desired. A routine (SAVE) is in- 
cluded to move the different memory 
areas to other areas that are com- 



00193 


4661 


05 


FC 






ORA 


TEMPER 


CURRENT = LOW) 


00194 


4663 


8D 


FD 


46 


CALCBT 


STA 


TEMPI 


SAVE IT FOR NOW 


99 195 


4666 


AD 


FC 


46 




LDA 


COLUMN 


IS COLUMN * 


99 196 


4669 


C9 


28 






CMP 


«40 


<40? 


99 197 


466B 


90 


03 






BCC 


SCR0 


YES, 60 ON 


99198 


466D 


4C 


F2 


46 




JMP 


RETURN 


OTHERWISE EXIT 


99 199 


4670 


A8 






SCR0 


TAY 




SAVE COL Y REG. 


09290 


467 1 


AE 


FB 


46 




LDX 


LINE 


LINE* IN X REG. 


9920 1 


4674 


BD 


00 


43 




LDA 


LTAB.X 


CONSTRUCT 


09202 


4677 


85 


FD 






STA 


PL 


VIDEO ADDRESS 


99293 


4679 


BD 


00 


44 




LDA 


HTAB.X 


FROM X=LINE 


90204 


467C 


85 


FE 






STA 


PH 


(0-199) 


09295 


467E 


B9 


D0 


43 




LDA 


LTABA , Y 




99206 


4681 


18 








CLC 




AND Y=HORI2 . 


99207 


4682 


65 


FD 






ADC 


PL 


BYTE (9-39) 


00208 


4684 


85 


FD 






STA 


PL 




00209 


4686 


90 


02 






BCC 


SCR1 




99219 


4688 


E6 


FE 






INC 


PH 




99211 


468A 


B9 


D0 


44 


SCR1 


LDA 


HTABA.Y 




99212 


468D 


18 








CLC 






09213 


468E 


65 


FE 






ADC 


PH 




99214 


4690 


85 


FE 






STA 


PH 




00215 


4692 


A0 


00 






LDY 


N«00 


FINALLY, GET 


00216 


4694 


Bl 


FD 






LDA 


(PL) ,Y 


;BYTE FROM SCREEN 


99217 


4696 


8D 


FE 


46 




STA 


TEMP2 


.HOLD IT 


90218 


4699 


AD 


F8 


46 




LDA 


COUNTL 


iFIND MOD(8) OF 


99219 


469C 


29 


07 






AND 


#*07 


; PULSE 


00220 


469E 


C9 


02 






CMP 


**02 


;>i? 


00221 


46A0 


B0 


14 






BCS 


B2 


YES, BRANCH 


99222 


46A2 


AD 


FE 


46 


B0 


LDA 


TEMP2 




99223 


46A5 


29 


3F 






AND 


(t*3F 


MASK- 001 1 1 1 1 1 


90224 


46A7 


8D 


FE 


46 




STA 


TEMP2 




00225 


46AA 


AD 


FD 


46 




LDA 


TEMPI 




99226 


46AD 


0A 








ASL 


A 


MOVE THE TWO 


99227 


46AE 


0A 








ASL 


A 


BITS TO THE 


99228 


46AF 


0A 








ASL 


A 


TWO HIGH BITS 


00229 


4660 


0A 








ASL 


A 


7 AND 6 


09230 


46B1 


0A 








ASL 


A 




00231 


46B2 


0A 








ASL 


A 




00232 


46B3 


4C 


EB 


46 




JMP 


B8 




00233 


46B6 


C9 


04 




B2 


CMP 


#♦04 


>3? 


00234 


46B8 


B0 


12 






BCS 


B4 


YES, BRANCH 


09235 


46BA 


AD 


FE 


46 




LDA 


TEMP2 




90236 


46BD 


29 


CF 






AND 


t»*CF 


MASK" 11001111 


00237 


46BF 


8D 


FE 


46 




STA 


TEMP2 




00238 


46C2 


AD 


FD 


46 




LDA 


TEMPI 




00239 


46C5 


0A 








ASL 


A 


MOVE THE TWO 


00240 


46C6 


9A 








ASL 


A 


BITS TO THE 


00241 


46C7 


9A 








ASL 


A 


BITS NUMBERED 


00242 


46C8 


9A 








ASL 


A i 


5 AND 4 


09243 


46C9 


4C 


EB 


46 




JMP 


B8 




00244 


46CC 


C? 


06 




B4 


CMP 


#*06 ; 


>5? 


90245 


46CE 


BB 


10 






BCS 


B6 


YES, BRANCH 


99246 


46D0 


AD 


FE 


46 




LDA 


TEMP2 




00247 


46D3 


29 


F3 






AND 


#*F3 


MASK- 111100 11 


00248 


46D5 


8D 


FE 


46 




STA 


TEMP2 




00249 


46D8 


AD 


FD 


46 




LDA 


TEMPI 




09250 


46DB 


0A 








ASL 


A I 


SHIFT THEM TO 


00251 


46DC 


0A 








ASL 


A 


BITS 3 AND 2 


00252 


46DD 


4C 


EB 


46 




JMP 


BB 




00253 


46E0 


AD 


FE 


46 


B6 


LDA 


TEMP 2 




00254 


46E3 


29 


FC 






AND 


#«FC | 


MASK- 11111100 


00255 


46E5 


8D 


FE 


46 




STA 


TEMP2 




00256 


46E8 


AD 


FD 


46 




LDA 


TEMPI j 


ONLY THESE BITS 


00257 


46EB 


0D 


FE 


46 


B8 


ORA 


TEMP2 j 


AFFECT DATA 


00258 


46EE 


A0 


00 






LDY 


**00 




00259 


46F0 


91 


FD 






STA 


<PL),Y j 


CHANGE SCREEN 


00260 


46F2 


68 






RETURN 


PLA 


; 


RESTORE 


00261 


46F3 


A8 








TAY 


i 


REGISTERS 


00262 


46F4 


68 








PLA 






00263 


46F5 


AA 








TAX 






99264 


46F6 


68 








PLA 






00265 


46F7 


40 








RTI 






00266 


46F8 








1 








00267 


46F8 


00 






COUNTL 


.BYTE 




00268 


46F9 


00 






COUNTH 


.BYTE 




00269 


46FA 


00 






C0UNT8 


.BYTE 




00270 


46FB 


00 






LINE 


.BYTE 




00271 


46FC 


00 






COLUMN 


.BYTE 




00272 


46FD 


00 






TEMPI 


.BYTE 




00273 


46FE 


00 






TEMP2 


.BYTE 




00274 


46FF 


00 






SYNCFL 


.BYTE 




00275 


4700 


00 






CHKSFL 


.BYTE 




00276 


470 1 


00 






MODE 


.BYTE 6 
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patible with popular graphics 
programs. Here we move the 8K bit- 
map area starting at $2000 to $6000 + . 
The IK screen area starting at $0400 is 
moved to two locations, $5C00 and 
$7F40. The IK color memory starting 
at $D800 is moved to $8328, and the 
background color from $D021 to 
$8710. The reason for these memory 
moves are to prepare for a disk save 
routine. The above locations are com- 
patible with two packages, "DOODLE", 
a graphics program by Omni Unlimited, 
and "Koalapainter", by Audio Light. 
DOODLE is used for HIRES pictures, 
and KOALA for MULTIcolor pictures. 

The DISKSA routine will create a 
disk file in either mode, depending on 
the state of the mode flag. To use this 
routine, the file name and length of the 
name have to be previously stored in 
memory. 

Basic Program for FAX Driver 

Listing 3 is a Basic program that is 
used to control the machine language 
programs. First it reads into memory 
the ML part ("FAX64.ML") and the 
table of Listing 2 ("TABLE"). Then the 
top of memory is set to avoid conflicts 
with the graphics. 

The main menu allows four options: 
FAX scan, Display last scan, Save scan 
to disk, or Quit. Obviously, the F option 
is chosen the first time. You are then 
given the choice of a HIRES scan (only 
two colors) or a MULTIcolor scan (four 
colors). Then some other commands are 
shown and you are instructed to start 
the FAX machine. 

POKEs are made to start the in- 
terrupt routine (NMD and the software 
timer, as well as to configure the screen 
for graphics. At this point, the NMI 
routine is active in the background. The 
Basic program is in a do-nothing state, 
checking the keyboard for Q to quit or 
for color change keys. 

If MULTI mode is chosen, the colors 
can be changed either during a scan or 
after. The four function keys can be 
used to change any of the four colors. 
Fl is used for the brightest level 
(usually white), F3 for the next, etc. 
With these four keys, any color com- 
bination is possible. The number keys 
are used to select any of 10 preset color 
combinations. The '2' key selects 
shades of white (gray, black), the '3' key 
is used for shades of red, etc. Also, the 
'C key can be used to rotate from 1 to 2 



88277 


4702 








i 








88278 


4782 


88 






LENGTH 


.BYTE *ee 


jFOR DISKSA 


88279 


4783 


88 






NAME 


.BYTE 8,8,8,8,8 


8,8,8 


88279 


4784 


88 














88279 


4785 


88 














88279 


4786 


88 














88279 


4787 


88 














88279 


4788 


80 














88279 


4789 


88 














88279 


478A 


88 














88288 


470B 


88 






CONTD 


.BYTE 8,8,8,8,8 


6,8,8 


88288 


470C 


88 














88288 


470D 


00 














88288 


478E 


88 














88288 


478F 


88 














88288 


4710 


68 














88288 


471 1 


88 














88288 


4712 


88 














88281 


4713 








» 








88282 


4713 








SAVEKN 


=c 


65496 


;KERNAL 


88283 


4713 








SETLF5 


= 


65466 


; ROUTINES 


88284 


4713 








SETNAM 


= 


65469 




80285 


4713 
















88286 


4713 










SUBROUTINES FOR 


CLEAR 


88287 


4713 










SCREEN, SET COLORS 


88288 


4713 
















88289 


4713 


A8 


28 




CLRBIT 


LDY 


••♦28 




88298 


47 15 


8C 


43 


47 




STY 


L00PCL+2 




88291 


4718 


A9 


AA 






LOA 


••♦AA 




88292 


47 1A 


4C 


3F 


47 




JMP 


CLEAR 




88293 


471D 








» 








88294 


471D 


AD 


8 1 


47 


CLRC0L 


LOA 


MODE 




80295 


4728 


D8 


8A 






BNE 


CLRMUL 




80296 


4722 


A9 


81 




CLRHIR 


LOA 


••♦8 1 




88297 


4724 


A8 


84 




CLR1 


LDY 


••♦84 




88298 


4726 


8C 


43 


47 




STY 


LOOPCL+2 




88299 


4729 


4C 


3F 


47 




JMP 


CLEAR 




00300 


472C 








i 








8838 1 


472C 


A9 


81 




CLRMUL 


LOA 


••♦8 1 




00382 


472E 


8D 


21 


08 




STA 


♦ D8 21 




88303 


4731 


A9 


FC 






LOA 


••♦FC 




08384 


4733 


28 


24 


47 




JSR 


CLR1 




88385 


4736 


A9 


88 






LDA 


••♦08 




00386 


4738 


A8 


08 






LDY 


••♦D8 




88387 


473A 


8C 


43 


47 




STY 


LOOPCL+2 




80308 


473D 


A8 


84 






LDY 


••♦04 




88309 


473F 


A2 


88 




CLEAR 


LDX 


••♦00 




08318 


474 1 


9D 


88 


84 


L00PCL 


STA 


♦8488 ,X 




0031 1 


4744 


E8 








1NX 






00312 


4745 


D8 


FA 






BNE 


LOOPCL 




80313 


4747 


EE 


43 


47 




INC 


LOOPCL+2 




80314 


474A 


88 








DEY 






88315 


474B 


D8 


F4 






BNE 


LOOPCL 




80316 


474D 


68 








RTS 






88317 


474E 








S 








88318 


474E 


A0 


28 




SAVE 


LDY 


#♦28 


;8K BIT-MAP 


88319 


4758 


BC 


B3 


47 




STY 


MOVE 1 + 2 


; FROM ♦2868+ 


08328 


4753 


A9 


68 






LDA 


••♦68 


; TO ♦6868+ 


00321 


4755 


8D 


B6 


47 




STA 


MVTO+2 




68322 


4758 


A9 


68 






LDA 


#♦88 




68323 


475A 


8D 


B2 


47 




STA 


MOVE1+ 1 




66324 


475D 


8D 


B5 


47 




STA 


MVTO+ 1 




66325 


4768 


26 


AF 


47 




JSR 


MOVE 




66326 


4763 


A8 


64 






LDY 


••♦84 


; IK SCREEN 


66327 


4765 


ec 


63 


47 




STY 


MOVE 1 + 2 


| FROM ♦8488 


88328 


4768 


A9 


5C 






LDA 


•W5C 


i TO »5C68 


66329 


476A 


8D 


B6 


47 




STA 


MVTO+2 




88338 


476D 


A9 


88 






LDA 


•wee 




68331 


476F 


8D 


B2 


47 




STA 


MOVE 1 ♦ 1 




68332 


4772 


i CD 


B5 


47 




STA 


MVTO+ 1 




86333 


4775 


28 


AF 


47 




JSR 


MOVE 




00334 


4778 


A8 


84 






LDY 


••♦8 4 


) IK SCREEN 


88335 


477A 


8C 


B3 


47 




STY 


MOVE 1 + 2 


I ALSO TO 


88336 


477D 


A9 


88 






LDA 


••♦68 


1 ♦7F46 


88337 


477F 


8D 


B2 


47 




STA 


MOVE1+ 1 




68338 


4782 


A9 


7F 






LDA 


**7F 




88339 


4784 


80 


B6 


47 




STA 


MVTO+2 




88348 


4787 


A9 


46 






LDA 


••♦48 




8834 1 


4789 


8D 


B5 


47 




STA 


MVT0+ 1 




68342 


478C 


28 


AF 


47 




JSR 


MOVE 




88343 


478F 


A9 


08 






LDA 


••♦08 


j IK COLOR 


88344 


4791 


80 


B3 


47 




STA 


MOVE 1 + 2 


i from ♦Deee 


88345 


4794 


A9 


88 






LDA 


••♦68 


I TO «8328 


88346 


4796 


80 


B2 


47 




STA 


MOVE 1 ♦ 1 
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to 3, and so on. It should be noted that 
these color changes can be made while 
the machine is scanning since the 
program is running simultaneously 
with the NMI routine. 

The Save option first moves the 
memory areas, turns on the alpha 
screen, and asks you for a file name. 
This name is then configured to be 
compatible with either KOALA or 
DOODLE, and the name and its length 
are POKED into memory. You are then 
instructed to place a diskette into the 
disk drive. You can change disks at this 
point, but be sure you use previously 
formatted disks. Then the ML Save 
routine is called and you see the menu 
again. 

What Good is a FAX? 

What can you do with the FAX? 
Well, actually, it can prove to be the 
best graphic input device that you can 
use with your home computer. You can 
capture an image of any picture into 
your machine. By creating a disk file of 
the picture, you can then add text, fill in 
color areas, or enhance the images with 
other graphic packages. You can dump 
these pictures to your printer with an 
appropriate printer dump program. 
And you can do it even if you are not 
very good at drawing. 

Some Helpful Hints 

Make sure the picture you feed into 
the FAX is of sufficient contrast and is 
not bathed in dark shadows. Do not at- 
tempt to use it to read in fine text — the 
interface is configured to reduce the 
resolution to that of C-64 graphics 
capability. Make sure the 'brightness' 
control is set up right so that the 
machine is putting out four different 
levels to your computer. To set it, make 
yourself a 'test pattern' with different 
gray levels, and digitize it in MULTI 
mode. 

If you have more questions, 
suggestions, or have found a unique ap- 
plication for the FAX machine, write to 
me at 713 Locust Drive, Tallmadge, 
Ohio 44278. 1 can supply the C-64 FAX 
driver programs in Commodore 1541 
disk format for $10. A FAX machine as 
used in this article can be obtained from 
Computer Products & Peripherals 
Unlimited, Box 204, Newton, New 
Hampshire 03858, for approx. $169. ■ 



86347 


4799 


A9 


83 






LDA 


*«83 




06348 


479B 


8D 


B6 


47 




STA 


MVTO*2 




86349 


479E 


A9 


28 






LDA 


#♦28 




66356 


4 7A6 


8D 


B5 


47 




STA 


MVTO* 1 




86351 


47A3 


A8 


84 






LDY 


**84 




88352 


47A5 


28 


AF 


47 




JSR 


MOVE 




66353 


47A8 


AD 


21 


D6 




LDA 


♦ D621 


I 1 BYTE «D8 21 


86354 


47AB 


8D 


16 


87 




STA 


♦ 8716 


; TO *8718 


68355 


47AE 


68 








RTS 






66356 


47AF 
















68357 


47AF 


A2 


68 




MOVE 


LDX 


N«86 


;MOVE 


86358 


47B1 


AD 


88 


64 


MOVE1 


LDA 


*8486 


; SUBROUTINE 


88359 


47B4 


8D 


48 


7F 


MVTO 


STA 


«7F48 




66368 


47B7 


EE 


B2 


47 




INC 


MOVE1+ 1 




68361 


47BA 


AD 


B2 


47 




LDA 


MOVE1+ 1 




86362 


47BD 


D8 


83 






BNE 


MV1 




66363 


47BF 


EE 


B3 


47 




INC 


MOVE 1 + 2 




88364 


47C2 


EE 


B5 


47 


MV1 


INC 


MVTO + 1 




86365 


47C5 


AD 


B5 


47 




LDA 


MVTO + 1 




86366 


47C8 


D8 


83 






BNE 


MV2 




68367 


47CA 


EE 


B6 


47 




INC 


MVTO+2 




66368 


47CD 


E8 






MV2 


INX 






88369 


47CE 


D8 


El 






BNE 


MOVE1 




86378 


47D8 


88 








DEY 






86371 


47D1 


D8 


DE 






BNE 


MOVE1 




88372 


47D3 


68 








RTS 






66373 


47D4 








J 








88374 


47D4 


A2 


88 




D1SKSA 


LDX 


#♦6 8 


ROUTINE TO 


88375 


47D6 


A9 


87 






LDA 


#*87 


SAVE THE 


88376 


47D8 


A8 


86 






LDY 


N«ee 


GRAPHICS 


68377 


47DA 


28 


BA 


FF 




JSR 


SETLFS 


TO DISK IN 


88378 


47DD 


AD 


82 


47 




LDA 


LENGTH 


FORMATS: 


88379 


47E6 


A2 


83 






LDX 


(KNAME 




68388 


47E2 


A8 


47 






LDY 


#>NAME 


HIRES- 


66381 


47E4 


28 


BD 


FF 




JSR 


SETNWM 


DOODLE 


88382 


47E7 


AD 


81 


47 




LDA 


MODE 




86383 


47EA 


F8 


18 






BEQ 


HIRESC 


MULT I - 


66384 


47EC 


A9 


68 






LDA 


#♦68 


KOALA 


86385 


47EE 


85 


FE 






STA 


PL* 1 




88386 


47F8 


A2 


1 1 






LDX 


MSI 1 




88387 


47F2 


A8 


87 






LDY 


#*87 




68388 


47F4 


A9 


88 




TOSAVE 


LDA 


ttsee 




88389 


47F6 


85 


FD 






STA 


PL 




88398 


47F8 


A9 


FD 






LDA 


•KPL 




88391 


47FA 


28 


D8 


FF 




JSR 


SAVEKN 




88392 


47FD 


88 


82 






BCS 


ERR 




88393 


47FF 


A9 


86 






LDA 


t»*86 




88394 


488 1 


85 


FD 




ERR 


STA 


PL 




68395 


4883 


66 








RTS 






68396 


4884 


A9 


5C 




HIRESC 


LDA 


t»«5C 




88397 


4886 


85 


FE 






STA 


PL+1 




88398 


4888 


A2 


88 






LDX 


M*ee 




86399 


488A 


A8 


86 






LDY 


tt*86 




68468 


486C 


D8 


E6 






BNE 


TOSAVE 




88461 


488E 








t 








88482 


486E 








.END 









ERRORS 



88888 



SYMBOL TABLE 














SYMBOL VALUE 














ACTIVE 


4627 


B8 


46A2 


B2 


46B6 


B4 


46CC 


B6 


46E8 


B8 


46EB 


CALCBT 


4663 


CHKSFL 


4788 


CHKWH 


455B 


CLEAR 


473F 


CLR1 


4724 


CLRBIT 


4713 


CLRCOL 


471D 


CLRHIR 


4722 


CLRMUL 


472C 


COLUMN 


46FC 


CONTD 


478B 


COUNT 8 


46FA 


COUNTH 


46F9 


COUNTL 


46F8 


DATA IN 


DD6 1 


DISKSA 


47D4 


ERR 


488 1 


HIRES 


4658 


HIRESC 


4884 


HTAB 


4488 


HTABA 


44D8 


ICR 


DD6D 


Kl 


45AE 


K2 


45B9 


KRT 


45C1 


KSYNC 


4591 


LASTBL 


454A 


LENGTH 


4782 


LINE 


46FB 


LOCKED 


456F 


LOOPCL 


4741 


LRT 


4588 


LTAB 


4388 


LTABA 


4308 


MODE 


478 1 


MOVE 


47AF 


MOVE1 


47B1 


MULTI 


464F 


MV1 


47C2 


MV2 


47CD 


MVTO 


47B4 


N8 


4514 


Nl 


4583 


N2 


45C4 


N3 


45ED 


N4 


45F5 


N5 


4684 


N6 


4624 


NAME 


4783 


NEWM1I 


4588 


NRT 


45EA 


NSTART 


468F 


ODD 


464A 


PH 


68FE 


PL 


88FD 


RETURN 


46F2 


SAVE 


474E 


SAVEKN 


FFD8 


SAVREG 


4587 


SCR8 


4678 


SCR1 


468A 


SETLFS 


FFBA 


SETNAM 


FFBD 


SYNC 


4526 


SYNCFL 


46FF 


TEMP 


88FB 


TEMPI 


46FD 


TEMP2 


46FE 


TEMPEV 


B8FC 


TOSAVE 


47F4 


TWOBIT 


463A 


WHITE 


4638 


WHZERO 


4558 


ZWHT 


454 1 
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Listing 2. Table o-f O-f-fsets -for Screen Memory 
Addr Data 



4360 


60 


81 


02 


03 


04 


05 


06 


07 


40 


41 


42 


43 


44 


45 


46 


47 


4318 


80 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


c6 


c7 


4326 


00 


6 1 


02 


03 


84 


05 


86 


07 


40 


41 


42 


43 


44 


45 


46 


47 


4330 


80 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


c6 


c7 


4340 


00 


61 


02 


03 


64 


65 


8 6 


07 


40 


41 


42 


4 3 


44 


45 


46 


47 


4350 


80 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


c6 


c7 


4368 


00 


01 


2 


03 


04 


05 


6 


07 


40 


41 


42 


43 


44 


45 


46 


47 


4370 


80 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


c6 


c7 


4388 


60 


01 


02 


03 


6 4 


65 


6 


07 


40 


41 


42 


43 


44 


45 


46 


47 


4390 


80 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


C6 


c7 


43a0 


60 


01 


02 


03 


04 


5 


6 6 


07 


40 


4 1 


42 


43 


44 


45 


46 


47 


43b0 


86 


81 


82 


83 


84 


85 


86 


87 


C0 


c 1 


c2 


c3 


c4 


c5 


c6 


c7 


43c0 


06 


01 


02 


03 


64 


05 


66 


07 


06 


00 


00 


00 


00 


60 


66 





43d0 


00 


08 


10 


IS 


26 


28 


30 


38 


40 


48 


50 


53 


60 


68 


76 


78 


43e0 


80 


88 


96 


98 


a6 


a 8 


b0 


b8 


C0 


cS 


d6 


d8 


e6 


e8 


* 8 


+ 8 


43-f 


80 


08 


10 


18 


20 


28 


30 


38 


60 


00 


00 


00 


00 


00 


00 


00 


4480 


20 


20 


20 


26 


26 


26 


20 


28 


21 


21 


21 


21 


21 


21 


21 


21 


4410 


22 


22 


22 


22 


22 


22 


22 


22 


23 


23 


23 


23 


23 


23 


23 


23 


4420 


25 


25 


25 


25 


25 


25 


25 


25 


26 


26 


26 


26 


26 


26 


26 


26 


4430 


27 


27 


27 


27 


27 


27 


27 


27 


28 


28 


28 


28 


28 


28 


28 


28 


4446 


2a 


2a 


2a 


2 a 


2 a 


2a 


2 a 


2a 


2b 


2b 


2b 


2b 


2b 


2 b 


2b 


2 b 


4450 


2c 


2c 


2c 


2c 


2c 


2c 


2c 


2c 


2d 


2d 


2d 


2d 


2d 


2d 


2d 


2d 


4466 


2-f 


2-f 


2-f 


2-f 


2-f 


2-f 


2 + 


2-f 


38 


30 


30 


30 


30 


36 


36 


30 


4470 


31 


31 


31 


31 


31 


31 


31 


31 


32 


32 


32 


32 


32 


32 


32 


32 


4480 


34 


34 


34 


34 


34 


34 


34 


34 


35 


35 


35 


35 


35 


35 


35 


35 


4490 


36 


36 


36 


36 


36 


36 


36 


36 


37 


37 


37 


37 


37 


37 


37 


37 


44a0 


39 


39 


39 


39 


3y 


39 


39 


39 


3a 


3a 


3a 


3a 


cia 


3a 


3a 


3 a 


44b0 


3b 


3b 


3b 


3b 


3b 


3b 


3b 


3b 


3c 


3c 


3c 


3c 


3c 


3c 


3c 


3c 


44c8 


3e 


3e 


3e 


3e 


3e 


1 e 


3e 


3e 


86 


00 


6 


00 


6 


00 


00 





44d0 


00 


00 


00 


00 


66 


00 


00 


00 


00 





00 


00 


60 


00 


00 


00 


44e8 


06 


08 


06 


00 


06 


6 


08 





00 


00 





00 


68 


68 


00 


68 


44-f0 


01 


01 


1 


1 


01 


1 


1 


1 


00 


00 


00 


06 


00 


88 


08 


86 



LISTING 3. BASIC FAX DRIVER PROGRAM 



18 REMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

28 REMX * 

38 REM* FAX-DRIVER M.J.KERYAN X 

48 REMX FOR C-64 9-84-84 X 

58 REMX X 

68 REMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 

78 IF A=8 THEN A= 1 : LOAD " TABLE ",8,1 

88 IF A»l THEN A»2s LOAD " FAX64 .ML" , 8 , 1 

98 P0KE52,32:P0KE56,32iP0KE644,32: CLR 

188 DIM C(9,3) : CR=2 

118 FOR I-8T09: FOR J-1T03: READ C(I,J): NEXT: NEXT 

128 C1-18221J C2-18226: C3-18231 

138 DATA 1,173,6, 15,148,8 

140 DATA 1,252,8, 1, 162,8 

158 DATA 3,238,8, 2,164,6 

168 DATA 1,213,8, 1,230,8 

178 DATA 1,128,9, 1,169,8 

188 REM MENU 

198 GOSUB 1418 

208 PRINT" 

210 PRINT' <F> 

228 PRINT"<DWN> 

238 PRINT*<DWN> 

248 PRINT" <DWN> 

258 PRINT" ?" 



<RON>FAX MENIKDUMXDWNV 

FAX SCAN 
<D> DISPLAY LAST SCAN 
<S> SAVE SCAN TO DISK 
<Q> QUIT" : PRINT 



Watch For These Upcoming Articles 

The following list is a sample of some of the in- 
teresting articles which are in process Your 
suggestions for future articles are welcome 

• Interfacing a parallel printer througn the 
Apple game port. 

• Dumping the S-100 graphics card .mage to 
an Epson printer. 

• Using bank switching for an extencerj 
CBIOS. 

• Communicating with your computer ove r the 
phone line without a modem Dy using TONE 
CONTROL. 

• Review of the Light Speed-100 256K S-100 
Disk Simulator Kit 

• A $500 Superbrain Computer, the p r os and 
cons of buying out of date used equipment 

• FORTH— Using the CREATE. . . DOES con- 
struct. 

• Source code drivers for the NEC7220 
graphics chip. 

• Accessing the Apple ll's graphics from 
within a CP/M program using a Z-80 card 

• Kit Building— soldering, desoldering, and 
repairing printed circuit boards 



268 GET K*i IF «*<>"" THEN 268 

278 GET K«: IF K*»"" THEN 278 

280 IF K*«"F" THEN SC- 1 ! GOTO 338 

290 IF K*-"Q* THEN GOTO 1348 

300 IF K*«"D* THEN 930 

310 IF K*--S" THEN GOSUB 860: GOTO 1098 



Reviewers Needed 

We are looking for qualified people to review 
technical programs and hardware for The Computer 
Journal. We do not need reviews of Lotus 1 -2-3 or 
similar spreadsheets, wordprocessors. or gene r al 
business type programs: we'll leave that to the 
general interest magazines What we do need are 
reviews of compilers, assemDiers. disassemblers, 
debuggers, programming utility libraries, scientific 
and engineering programs, data acquisition and 
analysis programs, operating system enhancemen- 
ts, and similar items which are used by program- 
mers. 

We are also interested in reviews of specialized 
hardware such as A/D and 0/ A interfaces, EPROM 
programmers, stepper motor controllers, and 
kits— but not most new computers or penphe r a!s. 
unless there is some technical aspect of special in- 
terest to our readers. 

We prefer reviews from people who are actually 
using the product rather than from someone who 
reviews many different products without using any 
one of them long enough to become completely 
familiar with all of its features. The reviews should 
be truthful and should tell it like it is, but the best 
reviews are the ones you write about products that 
you like and want to encourage others to use 

If you are interested in writing reviews, send us a 
short letter with your background and 
qualifications, and a phone number where you can 
be reached in the evening. Include products which 
you now have available for review, and also items 
which you would be interested in reviewing if we 
could obtain a review copy ■ 
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328 GOTO 268 

338 PRINT" <DWN> ENTER: <8> FOR HIRES (BLACK/WHITE)' 

348 PRINT" <DWN> OR < 1> FOR MULTI (4 COLOR LEVELS)" 

358 GETK»: IFK*<>"" THEN 338 

368 PRINT" <DWN> "j (INPUT MODE : I F MODE<8 OR MODE> 1 

THEN 338 
378 PRINT" <CLRXDWNXR0N>WH1LE SCANNING, PRESS:" 
388 PRINT" <DWN> <T> TO START AT TOP" 
398 PRINT" <DWN> <S> TO SYNCHRONIZE t* RESTART" 
488 IF MODE>8 THEN PRINT"<DWN> <C> TO ROTATE COLORS" 
418 IF MODE>8 THEN PRINT"<DWN> <8-9> TO CHANGE COLORS" 
428 IF M0DE>8 THEN PRINT"<DWN> <F1-F7> TO CHANGE A 

COLOR" 
438 PRINT"<DWN> <Q> TO QUIT" 
448 PRINT"<DWNXDWNXDWNXRON>NOW START THE FAX MACHINE." 

458 for i»iToieeee: NEXTI 

468 SYS 18195: REM CLEAR 8K BIT-MAP 

478 POKE 18177, MODE 

488 POKE C1,C(CR,1): POKE C2,C(CR,2): POKE C3,C(CR,3) 

498 IF KC>2 THEN POKE Cl.CAr POKE C2.CB: POKE C3.CC 

588 SYS 18285: REM SET COLORS 

318 FOR I-18168T018176: POKEI.8: NEXTI 

528 POKE 33272, (PEEK( 53272) OR 8) 

538 POKE 53265, <PEEK< 53265) OR 32) 

548 IF MODE-8 THEN POKE 53278,8 

558 IF MODE=l THEN POKE 53278,24 

568 POKE 792,8: POKE 793,69 

578 POKE 56591,8: POKE 56579,8: POKE 56589,127 

588 POKE 56582,84: POKE 56583,1: POKE 56591,23: POKE 56589, 

138 
598 REM NOW THE NM1 ROUTINE HAS STARTED 
688 GET K*: IF K*<>"" THEN 688 
618 GET K*: IF K*-" " THEN 616 
628 IF K*»"Q" OR K»="E" THEN SYS 18254: GOSUB 868: GOTO 

188 
638 IF MODEO THEN 688 

648 IF ASC<K*)>47 AND ASC(K«)<58 THEN KC= 1 : GOTO 688 
658 IF K*«"C" THEN KC=2: GOTO 718 
668 IF K*="< Fl>" OR K*="< F3>" OR K*="< F5>" OR K*~"< 

F7>" THEN KC-3: GOTO 748 
678 GOTO 688 
688 CR»VAL(K«) 

698 POKE C1,C(CR,1): POKE C2,C(CR,2): POKE C3,C(CR,3) 
788 GOTO 858 

718 CR-CR+1: IF CR>9 THEN CR=8 

728 POKE C1,C<CR,1): POKE C2,C(CR,2): POKE C3,C<CR,3> 
738 GOTO 858 

748 IF K«0"< Fl>" THEN 778 
758 CA-PEEKCCD + 1: IF CA>15 THEN CA-8 
768 POKE Cl.CA: GOTO 858 
778 IF K*<>"< F3>" THEN 888 

788 CB-<PEEK<C2)AND248)/16+1: IF CB> 15 THEN CB=»8 
798 POKE C2,<CBX16)+(PEEK<C2>AND15) : CB=PEEK<C2): GOTO 

858 
888 IF K»<>"< F5>" THEN 838 

818 CB-<PEEK(C2)AND15>+1: IF CB> 15 THEN CB-8 
828 POKE C2,<PEEK<C2)AND248)+CB: CB-PEEKCC2): GOTO 858 
838 CC-PEEK(C3) + li IF CO 15 THEN CC=8 
848 POKE C3.CC i GOTO 838 
858 SYS 18285: GOTO 688 
868 REM RESET SCREEN TO ALPHA 
878 POKE 53265, <PEEK< 53265) AND 223) 
888 POKE 53278,8: POKE 53272,21 
898 SYS 64931: SYS 64789 
988 SYS 65371 
918 GOSUB 1418 
928 RETURN 

938 PRINT"<DWNXRON>WHILE VIEWING, PRESS:" 

948 IF MODE>8 THEN PRINT" <DWN> <C> TO ROTATE COLORS" 
958 IF MODE>8 THEN PRINT" <DWN> <8-9> TO CHANGE COLORS" 
968 IF MODE>8 THEN PRINT*<DWN> <F1-F7> TO CHANGE A 

COLOR" 
978 PRINT"<DWN> <G» TO QUIT" 
988 FOR I-1T04888: NEXTI 
998 POKE 18177, MODE 

1888 POKE C1,C<CR,1): POKE C2,C(CR,2)i POKE C3.CCCR.3) 
1818 IF KC>2 THEN POKE Cl.CA: POKE C2.CB: POKE C3.CC 

continued on page 31 
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Soul of CP/M: Using and Modifying CP/M's Internal 
Features 

Teaches you how to modify BIOS, w CP/M system calls in your own programs, and 
more! Excellent for those who have read CP/M Prtmer or who otherwise understand 
CP/M's outer-layer utilities. By Mitchell Wsite. Approximately loOpages. 8x9Vi, comb. 
©1»»3 $18.»6 

The Programmer's CP/M Handbook 

An exhaustive coverage of CPM 80" . its internal structure and major components is 
presented. Written for the programmer, this volume includes subroutine examples for 
etch of the CP'M system calls and information on how to customize CP/M - complete with 
detailed source codes for all examples. A dozen utility programs are shown with heavily 
annotated C-ianguage source codes. An invaluable and comprehensive tool for the serious 
programmer. By Andy Johnson Laird. 750 pages. 7Vix9'/«. softbound $21.95 

Interfacing to S-100 (IEEE 696} Microcomputers 

This book is a must if you want to design a custom interface between an S-100 
microcomputer and almost any type of peripheral device. Mechanical and electrical design 
is covered, along with logical and electrical relationships, bus interconnections and more. 
By Sol Libes and Mark Garetz. 322 pages. 6Vix9'A, softbound $16.95 

Microprocessors for Measurement and Control 

You'll learn to design mechanical and process equipment using microprocessor based 
"real time" computer systems. This book presents plans for prototype systems which 
allow even those unfamiliar with machine or assembly language to initiate projects. By 
D.M. Auslander and P. Sagues. 310 pages, 7 3/8x9 1/4. softbound 118.96 

Understanding Digital Logic Circuits 

A working handbook for service technicians and others who need to know more about 
digital electronics in radio, television, audio, or related areas of electronic troubleshooting 
and repair. You're given an overview of the anatomy of digital-logic diagrams and 
introduced to the many commercial IC packages on the market. By Robert G. Middlelon. 
392 pages. 5'/.x8'/i, softbound $18.95. 

Real Time Programming: Neglected Topics 

This book presents an original approach to the terms, skills, and standard hardware 
devices needed to connect a computer to numerous peripheral devices. It distills technical 
knowledge used by hobbyists and computer scientists alike to useable, comprehensible 
methods. It explains such computer and electronics concepts as simple and hierarchical 
interrupts, ports. PIAs. timers, converters, the sampling theorem, digital filters, closed 
loop control systems, multiplexing, buses, communication, and distributed computer 
systems. By Caxton C. Foster. 190 pages, «'Ax9 , 4, softbound $9.95 



Interfacing Microcomputers to the Real World 

Here is a complete guide for using a microcomputer to computerize the home, office, or 
laboratory. It shows how to design and build the interfaces necessary to connect a 
microcomputer to real world devices. With this book, microcomputers can be programmed 
to provide fast, accurate monitoring and control of virtually all electronic functions - from 
controlling houselights. thermostats, sensors, and switches, to operating motors, 
keyboards, and displays. This book is based on both the hardware and software principles 
of the Z80 microprocessor (found in several minicomputers. Tandy Corporation's famous 
TRS80. and others). By Murray Sargent III and Richard Shoemaker. 288 pages. 6'l>i9<k. 
•oftbound $15.55 

Mastering CP/M 

Now you can use CP/M to do more than just copy files For CP/M users or systems 
programmers -this book takes up where our CP/M handbook leaves off. It will give you 
an indepth understanding of the CP/M modules such as. CCP (Console Command 
Processor!. BIOS (Basic Input/Output Systeml. and BDOS (Basic Disk Operating Systeml. 
Find out how to: incorporate additional peripherals with your system, use console I/O. use 
the file control block and much more. This book includes a specal feature-a library of 
useful macros. A comprehensive set of appendices is included as a practical reference tool. 
Take advantage of the versatility of your operating system! By Alan R. Miller. 398 pages. 
6*x9". softbound tig 95 

FORTH Tools, Volume One 

FORTH Tools is a comprehensive introduction to the new international FORTH 83 
Standard and all its extensions. It gives careful treatment to the CREATE DOES 
construct, which is used to extend the language through new classes of intelligent data 
structures. FORTH Tools gives the reader an in-depth view of input and output, from 
reading the input stream to writing a simple mailing list program. Each topic is presented 
with practical examples and numerous illustrations. Problems land solutionsl are provided 
at the end of each chapter. FORTH Tools is the required textbook for the UCLA and IC 
Berkeley extension courses on FORTH. By Anita Anderson and Martin Tracy. 218 pages. 
5'Ax8'4. softbound $20.00 

TTL Cookbook 

Popular Sams author Dan Lancaster gives you a complete look at TTL logic cireuita, the 
moat inexpensive, moat widely applicable form ot electronic logic. la ao-nonMnae 
language, be spells out just what TTL is. bow it works, aad bow you can use It- Many 
practical TTL applications are examined. Including digital counters, electron* 
stopwatch**, digital voltmeters, and digital tachometers. By Don Lancaster. 336 pages. 
6'Ax8Vi, son. ©1974 MM 
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THE COMPUTER CORMER 

A Column by Bill Kibter 



W ell, so starts a new year and a 
new column. In the past year of writing 
for The Computer Journal, I have 
passed over many little topics and in- 
teresting tidbits. My recent articles on 
"tricks of the trade" were attempts to 
cover some of these topics, yet far too 
many words of wisdom never make it 
into print. Considering too, the many 
questions I receive from fellow com- 
puterists, there seems to be a need for a 
regular column. 

As a contributing editor of The Com- 
puter Journal it will be my duty to an- 
swer your letters of inquiry when 
possible, as well as those I receive in 
some of my other activites. This will 
not stop the major articles on other 
topics but will allow you to see how I 
am doing with a project, and in fact, 
give you a chance to comment on it 
before completion. A major problem I 
face in writing articles about hardware 
is the long development time needed to 
prepare an article. I am currently 
working on a series of articles based 
around the Superbrain computer. Just 
gathering and sifting the data has 
taken several months. It is now possible 
to actually sit down and get started on 
writing the articles and making the 
changes I have in mind. 

My primary work is with industrial 
computers, mainly those controlling 
process systems. Although these units 
are different than the normal personal 
computer, there are many facts and 
concepts that I come across which will 
be of interest to readers. One such area 
is the use of small systems running For- 
th for control applications. I am curren- 
tly toying with building the Rockwell 
Forth system or making a Z80 Forth 
unit. In either case I am interested in 
others' experiences and in your com- 
ments. Having the Rockwell unit in my 
hands for one night was fun, but at the 
time I did not have all the documents I 
needed to do a write up on it. 

Being somewhat of a purist, it has 
taken me some time to give up my 8' 
drives. Still, the price of new 5'/i * 



drives has dropped so much that I must 
admit to shifting over to them. Now 
don't get me wrong — I still have an 8" 
disk system — but now most of my work 
is on minis. Is this trend important? I 
think so. Why? There are many things 
happening with computers these days, 
and most of them are not technical. The 
hardware is becoming the least impor- 
tant aspect of the system, and software 
is definitively the new challenge on the 
horizon. This change means a lack of 
available supplies for older systems. 
The industry is going where the most 
money is to be made, and the money is 
in minis, not maxis. It is getting harder 
to find 8" diskettes for under two 
dollars, but I can get 5's for a dollar 
even. 

My Z100 computer has found a new 
home, and Gerry, the new owner, is fin- 
ding out about all the little points I 
never had time to investigate. One 
complaint of mine was the absence of a 
configuration program. The problem 
concerns the ever-increasing size of 
BIOSs. These started out under 2K in 
length and now run several "K" long. 
The ZIOO's BIOS is in two parts under 
CP/M 85, and the MSDOS is several in- 
ches thick. When adding 8" drives or 
changing to non-standard units it will 
be necessary to patch the BIOSs. In the 
old days this was no problem, but now 
the Z100 is a nightmare and a half. The 
problem is not one of bringing out the 
control values into accessible tables. 
The sign of a good BIOS is that all of 
the parameters are located in one place, 
making patching and configuration 
programs possible. Users with ZDOS 
1.0 will be pleased to see ZDOS 2.0 with 
a configuration program. 

When dealing with different 
systems, I guess the most common 
problem for me is that of transferring 
data. My solution is Modem7 and its file 
transferring options. Running two 
systems and doing my work on 5's and 
then shipping it out on 8's has me using 
Modem7 all the time. When I was 
working at Micropro we had a program 



for our development systems that 
allowed one unit to be a slave to the 
other. Similar to BYE, this program 
caused the slave drives to become "C" 
and "D" drives. If somebody has writ- 
ten such a program, please let me know, 
as I haven't found a copy of the old one. 
Reinventing this program for generic 
CP/M systems is my next project, so let 
me know if you have any ideas on just 
such a program. 

I spent the other day reading about 
CPNET and got some ideas on the 
transfer program. Seems Digital 
Research uses the BDOS calls to con- 
trol their headers in packetting the 
data to transfer. This has got me 
thinking of doing some pushing of 
registers to create the data packet, and 
then just popping them and calling the 
BDOS entry point. This sounds simple 
until you sit down and start writing the 
code, but now I have a point to start 
from. There is also a HAM radio packet 
program on SIG/M disks that may shed 
more light on the subject. As I study 
the problem more, it appears that get- 
ting the data packet or format is the 
part that can cause the most problems. 

The new year is here and with it the 
return of the swap meets. I went to my 
first one of the year last weekend, and 
was rather surprised at the change of 
products. Prices are down as many 
companies are going under and 
unloading their warehouses. Another 
change I've seen is the absence of S-100 
boards, or at least a change in their 
quantity. In the past, S-100 was the 
most common product at swap meets, 
but single boards and hard disks are 
now taking up most of the spaces. After 
the weekend meet, I need to change my 
statement that it is possible to build a 
system for under $800 — I think it is less 
than $500 now. 

Well that's about it for this month. 
Next month should contain reports on 
tying systems together, some $80 
minis, and what it is like being the 
editor of a local computer club newslet- 
ter. ■ 
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Interfacing Tips and Troubles 

A Column by Neil Bungard 



J. his month I would like to diverge 
from my series of articles on interfacing 
tools to stress a point concerning The 
Computer Journal, and to show you an 
easier way to interface your Sinclair 
ZX81 computer. 

There is so much information being 
generated in the area of computers that 
it is impossible for one person to keep 
up with it all. As an example, consider 
my recent articles on interfacing the 
Sinclair computers {The Computer 
Journal, Issues 13 and 14). In part one 
of this series I made the following 
statement: "The Sinclair machines do 
not support MMIO (Memory Mapped 
10)." I made this statement because 
while investigating the capabilities of 
the Sinclair machines, I was unable to 
make the machines respond using 
MMIO. However, as a result of a letter 
from LED of Michigan (Issue 14), I must 
"happily" retract my statement con- 
cerning MMIO on the Sinclair ZX81. 1 
say "happily" because using MMIO 
simplifies the task of interfacing the 
ZX81 considerably. The interfacing 
task is simplified because there are no 
machine language routines required, 
and the hardware problems associated 
with AIO do not occur when using 
MMIO. The only disadvantage of MMIO 
is that it is slower than AIO on the 
ZX81, but it is my experience that the 
speed limitations are not a problem in 
most applications. 

The hardware trick for using MMIO, 
as explained in LED's letter, is to direct 
the MMIO operations into the ZXSl's 
memory space between addresses 
8192(D) and 16383(D) (the (D) denotes 
decimal values). In addition, when in- 
formation is transferred to/from this 
memory space, a signal (logic 1) must be 
generated and placed on the ZX81's 
ROMCS edge connector (pin 23B). With 
these details taken care of, information 
can be transferred to/from an interface 
circuit using PEEK and POKE instruc- 
tions directly from BASIC. Using 
MMIO eliminates the need to wi-ite 
BASIC routines to load machine 
language programs, allocate space for 



machine language routines in REM 
statements, determine how data will be 
passed from the machine language 
programs to BASIC, and work around 
crashes and masked bits, all of which 
were required when using AIO on the 
ZX81. 

MMIO Hardware 

The circuit required to accomplish 
MMIO with the ZX81 is shown in 



Figure 1. Address lines A13, A14, A15, 
and 3 gates (two "OR" gates and 1 "IN- 
VERTER") from ICs 1 and 5 are 
required to decode the memory space 
which is used for MMIO on the ZX81. 
The 3 gates from ICs 1 and 5 configure 
a decoder which outputs a logic on pin 
6 of IC 1 any time memory locations 
8192 through 16383 are addressed. Pin 
6 of IC1 is connected to the output 
enable (pin 1) of tristate buffer IC6. 
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Figure 1: Schematic. Numbers in parenthesis denote pin number on ZX81 edge connector 
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Figure 2: Timing Diagram of MMIO operations. 



When pin 1 of IC6 is at a logic 0, the 
tristate buffer input (a logic 1 at pin 3) is 
connected through the buffer's output 
(pin 2) to the ZXSl's ROMCS input. A 
logic 1 on the ROMCS input disables 
the ZX81's internal ROM, thus allowing 
MMIO operations to be accomplished 
into the 8192(D) to 16383(D) memory 
space. 

Two 74LS138s (IC3 and IC4) 
generate 8 input and 8 output transfer 
pulses by decoding the ZX81's 3 lowest 
order address lines A0, Al, and A2. 
Address lines A0, Al, and A2 are con- 
nected to pins 1, 2, and 3 respectively of 
the 74LS138s and pins 5 and 6 of the 
74LS138s additionally decode the ad- 
dress bus by detecting when the 
8192(D) to 16383(D) memory space is 
being accessed. Timing of the transfer 
pulses is accomplished via a memory 
write (WR) signal and a memory read 
(RD) signal connected to pins 4 of ICs 3 
and 4 respectively. Figure 2 shows the 
timing diagrams of the MMIO 
operations. 

Information flows into (and out of) 
the ZX81 via an octal bus transceiver, 
IC7 in Figure 1. If address space 
8192(D) through 16383(D) is accessed, 
and a memory read operation is being 
performed, pin 1 of IC7 will be at a logic 
0, allowing data to be transferred into 
the ZX81. If address space 8192(D) 
through 16383(D) is accessed, and a 
memory write operation is being per- 
formed, pin 1 of IC7 will be at a logic 1, 
allowing data to be transferred out of 
the ZX81. The purpose of this octal bus 



transceiver is twofold. First of all, the 
transceiver isolates the ZX81 from the 
interface circuit, which would save the 
ZX81's internal circuitry if something 
went wrong on the interface circuit. 
Secondly, the transceiver will boost the 
ZX81's fanout. This means that more 
devices can be placed on the ZX81 data 
bus without loading the bus and causing 
current deficit problems. 

MMIO Software 

As mentioned earlier in this article, 
all information transfer between the 
ZX81 and an interface circuit can be ac- 
complished from the BASIC language 
set using PEEK and POKE instruc- 
tions. To accomplish MMIO using 
BASIC, you must first know where, 
within the 8192(D) to 16383(D) memory 
space, the interface circuit is actually 
mapped. When using the hardware con- 
figuration explained above, the 8 
memory locations between 8192(D) and 
16383(D) are used for input/output. 
Figure 3 shows which output pin on the 
74LS138s will supply the correct tran- 
sfer pulse when each of the 8 memory 
addresses are accessed. The software 
instructions which accomplish the 
MMIO are straightforward. To input 
data from an interface mapped into 
memory location 8192(D), you would use 
the following instruction: 
LET APEEK (8192) 

This instruction assigns the value ob- 
tained from the interface circuit (which 
will be a value between and 255) to 
the variable name A. Likewise, to out- 
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Input AddressPin # on IC3 

PEEK 819215 
PEEK 819314 
PEEK 819413 
PEEK 819512 
PEEK 819611 
PEEK 819710 
PEEK 81989 
PEEK 81997 

Output AddressPin H on IC4 

POKE 819215 
POKE 819314 
POKE 819413 
POKE 819512 
POKE 819611 
POKE 819710 
POKE 81989 
POKE 81997 

Figure 3 



put data to an interface mapped into 
memory location 8192(D), you would use 
the following instruction: 
POKE 8192.A 
This instruction transfers the value 
previously assigned to the variable 
name A (a value between and 255) to 
the interface circuit. 

Conclusion 

In conclusion, with memory mapped 
I/O and accumulator I/O now explained, 
the Sinclair ZX81 can be a very versatile 
computer for interfacing. AIO has its 
place where speed is a critical factor, as 
in applications where a number of 
values must be obtained in a second or 
less. But if your application requires 
acquisition times on the order of secon- 
ds or even greater, then MMIO offers 
you the simplicity to get your system 
working quickly and easily. As always, 
we appreciate your response to articles 
in The Computer Journal and look for- 
ward to hearing from you if you have 
questions or comments. ■ 
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Zsetsyou FREE! 

Z — y«»! Synergistic combination of 2CPR3 and ZRDOS2 produces 
flexible state-of-the-art Z80 operating system with tremendous produc- 
tivity features. 

Z-System consists of software modules, dynamic loading segments, 
and tools permitting optimum computer usage ranging from produc- 
tion program development to turnkey, password-controlled, end-user 
installations. Facilities include: multiple commands per line, file search 
paths, named directories, I/O redirection, command flow control, 
screen-oriented menu generators, complete housekeeping file and 
directory management, shells, alias (scripts) and nested-alias genera- 
tion, and complete online help 

Seventy-six support utilities, five tool packages, and two application 
programs available nowl Fully upward compatible with CP/M-80. 

Z can now be purchased as auto-install program (Z-Com) or as 
manual-install ZCPR3 with semi-auto install ZRDOS package (Z- 
System). Our latest versions, to be released this year, support Zilog 
Z800 and Hitachi HD62801/64180 high-technology chips, chips run 
existing 8080 and Z80 programs! 

Echelon eight-bit operating systems written in Assembly Language, 
using linkable macro subroutine libraries, offer performance parallel- 
ing best single-user 16/32-bit microcomputer systems. 

1. Z-Com Full-up Z Operating System with input/output redirection 
running under CP/M-80, online command and utility documentation 
and help system $219.95 

2. Z-System Manual-install ZCPR3 and ZRDOS2, easily tailored by 
programmer to custom needs; source code to core and utilities; similar 
to Item 1 $199.95 

3. Z-Tools Four software development system packages permitting 
advanced, structured program design, macro relocating assembler, 
linking loader, librarian, cross-reference generator, debugger, mne- 
monic and pseudo-op translators, and interactive disassembler. Super 
$315.00 package value $200.00 

4. DSD Dynamic Screen Debugger offers high-level features never 
before found in microcomputers; simultaneous display of dual-memory 
segments, stack, cpu states, and flags, with software In-Circuit- 
Emulation $149.00 

5. The Libraries Linkable ZCPR3 libraries (Vlib,Z3lib, and Syslib3) 
of over 400 subroutines used for Assembly Language program writing. 
Simplifies structured, efficient code production; online help system 

and full source code provided $45.00 

Syslib3 alone $29.00 

6. TarmS New generation communication program permits menu 
control of computer/modem operations between operator and time- 
share services, bulletin-boards and other remote computer systems; 
auto-answer to command-line prompt $99.00 

7. Discat Fancy file and disk catalog program running under Z- 
System, menu driven and easily customized by operator $49.00 

Fortnighter newsletter, 24-hour BBS Z-Node System keep Z users 
informed of microcomputer happenings. Write or call for brochure or 
order now! State disk format desired; add $3.00 shipping & handling; 
Californians please add 6-1/2% sales tax. Visa/MC, check, money or 
purchase order accepted. (Program names are trademarks of their 
respective owners.) 
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ANNO UN CEMENTS 

Artificial Intelligence 
Conference 

The premiere Artificial Intelligence 
and Advanced Computer Technology 
Conference/Exhibition is scheduled for 
April 30, May 1 and 2, 1985, at the Long 
Beach Convention Center, Long Beach, 
California. 

The exhibition showcases commer- 
cial and industrial applications of ad- 
vanced computers and software. 
Technical experts will present a con- 
ference focusing on AI in automated 
manufacturing, office automation, 
medicine, robotics, business, training, 
microcomputers, aerospace, and 
graphic simulation. Other topics will be: 
fifth generation computers, natural 
language interfaces, expert systems- 
development systems, speech 
recognition, image processing, 
cognitive modeling, knowledge infor- 
mation processing, and AI languages 
including LISP and PROLOG. 

Compete details are available from 
Tower Conference Management Co., 
331 W. Wesley St., Wheaton. IL 60187, 
phone (312) 668-8100. ■ 

Computer Interfacing 
Workshop 

Virginia Tech has announced a 
workshop on Personal Computer and 
STD Computer Interfacing for Scien- 
tific Instrument Automation. These 
courses, directed by David E. Larsen 
and Dr. Paul E. Field, will be held 
August 22, 23, and 24 in the 
Washington DC area, and September 
19, 20, and 21 in Greensboro, NC. The 
cost is $450 for the three day session, 
and details can be obtained from Dr. 
Linda Leffel, C.E.C., Virginia 
Polytechnic Institute, Blacksburg, VA 
24061. phone (703) 961-4848. ■ 

Universal RS-232 Data 
Acquisition 

Elexor has announced their PL-100 
intelligent peripheral which interfaces 
with any computer or terminal via a 
standard RS-232 serial port. It has 16 
channels of 12 bit A/D, 2 channels of 12 
bit D/A, 32 bits of digital I/O, 8K of 
ROM and 8K of RAM, plus provision for 
internal rechargeable batteries and two 
additional I/O boards. An on board 
microprocessor supports simple ASCII 
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commands or internal BASIC inter- 
preter. In addition, internal intelligence 
makes remote unattended applications 
possible using only a modem (no com- 
puter necessary). 

Prices start at $549, and more infor- 
mation is available from Elexor 
Associates, PO Box 246, Morris Plains, 
NJ 07950, phone (201) 299-1615. ■ 

DSD80 Debugger 

Soft Advances announces DSD80, a 
full screen symbolic debugging 
program for 8080, 8085 and Z80 
microcomputers running CP/M-80 and 
compatible operating systems. The 
dynamic display has instruction, register, 
stack and two memory windows. The 
Z80 instruction set is fully supported 
using either extended Intel or Zilog 
mnemonics. DSD80 has on-line help and 
comes with a fifty page user's manual. 
The price is $125 plus shipping from 
Soft Advances, PO Box 49473, Austin, 
TX 78765, phone (512) 478-4763. ■ 

IBM-PC Data Acquisition 
Software 

Data Translation has announced a 
series of application software packages 
to support its IBM-PC compatible data 
acquisition and control boards. These 
packages, intended for such ap- 
plications as chromatography, 
physiological and speech research, 
materials testing, and industrial con- 
trol, do not require the user to write 
original programs. 

DT/Notebook is an integrated, menu 
driven software package for real time 
data acquisition, process control, data 
analysis, and graphic display. It per- 
forms data acquisition at up to 20,000 
samples per second and real time 
graphic display of data at up to 600 
samples per second. 

DT/ILS-PC 1 is an interactive, com- 
mand driven digital signal processing 
package which supports continuous 
data acquisition to disk at up to 27,500 
samples per second. 

ASYST is a command driven package 
for real time data acquisition and con- 
trol, data analysis, and graphic displays 
able to acquire data at up to 27,500 
samples per second. More information 
on these products and their 
analog I/O boards can be obtained from 
Shari L. Supernault at Data Tran- 
slation, 100 Locke Drive, Marlboro, MA 
01752, phone (617) 481-3700. ■ 
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SOFTWARE 
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FAX-64 Listing 3, continued from page 25 

1826 SYS 18285: REM SETT COLORS 

1838 POKE 53272, <PEEK<53272) OR 8) 

1848 POKE 53265, <PEEK< 53265) OR 32) 

1858 IF M0DE=8 THEN POKE 53278,8 

1868 IF MODE-1 THEN POKE 53278,24 

1878 POKE 56591,8: POKE 56579,8: POKE 56589,127 

1888 GOTO 688 

1898 PRINT* <CLRXDWNXDWNXDWNXDWN> <RON>ENTER A NEW 

r**!E FOR FILE<ROF>* 

nee fl-14-mode*6: print* -fl* CHARACTERS MAXIMUM." 

1 1 10 F*»"NONAME*: INPUT"<DWN> ";F« 

1128 IF MODE>8 THEN: IF LEN(F*)<8 THEN F*-F*+" ": GOTO 

1128 

1138 IF LEN<F*)>FL THEN F*=LEFT*< F* , FL) 

1148 IF MODE-8 THEN F»="DD"+F» 

1158 IF MODE-1 THEN F*-CHR»< 129) + "PI C X "+F« 

1168 CL0SE15: 0PEN15,8,15 

1178 PRINT*<DWN> <RON>PUT DISK IN DRIVE 8, PRESS A 

KEY" 

1188 GET K«: IF K*«"" THEN 1188 

1196 IF K*-"Q" THEN 1298 

12ee PRINT#15,"I8" : GOSUB 1388 

1218 PRINT"<DWN> 

1228 GET K*: IF K 



IF E<1 THEN 125B 
<RON>PUT IN DISK NOW AND PRESS A KEY* 
" THEN 1228 



1238 IF K*-*Q* THEN 1298 

1248 GOTO 128 8 

1256 LL-LENCF*) : P0KE18178.LL 

1266 FOR IL-1T0LL: POKE 18178+IL, ASC<MID«<F*, IL , 1) > : 

NEXT IL 
1278 SYS 18388: REM SAVE TO DISK FILE 
1288 SC-8 

1298 CL0SE7: CLOSE 15: GOTO 188 
1386 REM ERROR CHECK 
1318 INPUT* 15, E,E«,E2,E3 
1328 IFETHENPRINT" XXX'E**XXX* 
1336 RETURN 

1346 IF SC>6 THEN 1366 

1356 P0KES2,168: P0KE56,168: P0KE644.168: CLR: END 
1366 PRINT" <DWNXRON>YOU HAVE NOT SAVED THE LAST PICTURE. 
1376 PRINT"<DWNXRON>DO YOU WANT TO QUIT?": K*-"N" 
1386 PRINT* <DWN>ENTER <Q> TO QUIT " | : INPUT K* 
1396 IF K*-"Q" THEN 1356 
I486 GOTO 168 
1416 PRINT"<CLRXBLUXDWNXDWNXDWNXDWN>" : POKE 53286, 

7 i POKE 53281,1: RETURN 
READY. 
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